Integration
ERPNext MCP server for Claude and ChatGPT
Ask Claude or ChatGPT about your ERPNext stock, invoices and reports, and have it draft documents. A connector that works with an API key you create and the permissions ERPNext already enforces.
Overview
Your ERPNext, inside Claude and ChatGPT.
Ask which customers are overdue, oldest first. Ask how much of an item is in each warehouse. Ask for a Sales Order to be drafted and look it over before it exists. The assistant does it against your own ERPNext site, and you never open a report screen.
The connector is an MCP server, the protocol Claude and ChatGPT use to talk to outside systems. Ours is at https://erpnext.iotready.app/mcp. It’s listed in Claude’s connector directory, and you can add it to ChatGPT as an app.
9
tools the assistant can call
3
access levels, read only by default
0
ERPNext documents stored by us
What can you ask it?
Anything ERPNext can answer, as long as the user behind the API key is allowed to see it.
Receivables
- “Which customers have unpaid invoices that are past due? Oldest first.”
- “Run Accounts Receivable for our company as of today and tell me the five biggest balances.”
Stock
- “How much of ITEM-001 do we have, in each warehouse?”
- “Which items have no stock movement in the last 90 days?”
Drafting (needs the Read and write level)
- “Draft a Sales Order for Acme Traders: 10 of ITEM-001 at 450 each, delivery next Friday.”
- “Set the customer PO number on SO-00012 to PO-4471.”
The assistant works out which doctypes to look at on its own. It reads the field list for a doctype before it queries it, so it doesn’t guess at your custom fields.
How do you connect ERPNext to Claude?
You need an ERPNext site that’s reachable over the internet with a valid HTTPS certificate. Cloud or self-hosted, either works. A site behind a VPN or an IP allow-list won’t.
- In ERPNext, create a user for the assistant and generate an API key and secret for it. The secret is shown once.
- In Claude, open Settings > Connectors and add
https://erpnext.iotready.app/mcp. In ChatGPT, add it as an app. - Sign in with Google, Microsoft, or a six-digit code sent to your email or mobile number. Then enter your site address, the key and the secret, and pick an access level. The connector makes a live call to your site to check the credentials before it saves anything.
- Approve the app and ask “Who am I connected as in ERPNext?”
The full walkthrough, with troubleshooting, is in the connector documentation.
Can it change my books?
Only as far as you let it. There are three access levels, and you can change the level, replace the key or disconnect from your account page at any time.
Read only
- Default level.
- Lookups and reports.
- Nothing in ERPNext can change.
Read and write
- Creates and updates documents.
- Drafts only. A plain create or update can’t submit or cancel.
- Every change waits for your approval first.
The third level, Full, also submits and cancels documents, which post to the general ledger and the stock ledger. Turn it on when you’ve watched the assistant draft a few things and trust what it does.
No level can delete a document. The tools for it don’t exist.
Is it safe to give an AI my ERPNext?
The assistant gets nothing ERPNext wouldn’t give the API user. That’s the design. Roles and permissions in ERPNext are the real limit, and the access level is a second, smaller one on top.
Your permissions apply. If the API user can't open Sales Invoices in ERPNext, neither can the assistant.
The key stays hidden. The secret is stored encrypted and is never shown again, to you or to the assistant.
You approve changes. Every tool that changes data asks first, unless you've told your assistant to always allow it.
We keep no documents. Results go straight to your assistant. We don't store them and we don't log what was asked.
Make a dedicated ERPNext user for this and give it only the roles it needs. Then the worst case is whatever that one user can do, and you can read that off the user’s role list.
What we do keep, and for how long, is in the privacy policy.
What tools does it expose?
| Level | Tools |
|---|---|
| Any | whoami, list_doctypes, describe_doctype, list_documents, count_documents, get_document, run_report |
| Read and write | create_document, update_document |
| Full | submit_document, cancel_document |
Lists return up to 100 documents a call, with paging. Reports return their first 200 rows. The limit is 120 requests a minute per account, and one ERPNext site per account.
How is this different from our ERPNext integration?
It’s a different thing, and the names are close enough to confuse.
This connector is for an ERPNext you already run, and the assistant is the only new part. You don’t need anything else from us.
Our ERPNext integration is the other direction. RFID readers, scales and scanners write stock movements into ERPNext through IoTReady Engine, and rules check each reading before it posts. If you want those, and you also want to ask Claude about the result, they work together.
Read next
Next step
Tell us what you are trying to trace.
Describe the flow: what arrives, what happens to it and what leaves. We will tell you what it takes to capture it.
or write to [email protected]