call_method
Call an ERPNext/Frappe whitelisted server-side API method. Can invoke any whitelisted method — use with caution. Args are passed as JSON body (POST) or query params (GET).
LABSCO SUMMARY
A custom DocType is reached the same way a Sales Invoice is.
Because the eleven tools are DocType-generic, nothing has to be added when your instance grows a new document type — get_doctype_fields tells the assistant what that record accepts before it writes one. call_method is the escape hatch for everything CRUD does not name, reaching any whitelisted Frappe method on the server.
What it is
A generic ERPNext and Frappe client. Eleven tools operate over any DocType: discover which exist, read their fields, query documents, create and update them, and move them through the submit and cancel lifecycle.
What you get
- The DocTypes your instance actually has, and the field list for any one of them
- Documents queried by DocType with filters, a chosen field set and a limit
- A single document fetched whole, child tables and linked data included
- Documents created and updated from a JSON payload
- The submittable workflow: submit sets docstatus to 1, cancel sets it to 2, and a cancelled document is amended into a corrected copy rather than edited
- Permanent deletion, with submitted documents required to be cancelled first
- ERPNext reports run by name with filters
- Any whitelisted Frappe server-side method called directly, with arguments as a JSON body or as query parameters
Requirements
A running ERPNext instance reachable at the address you put in ERPNEXT_URL, an API key and secret from it for ERPNEXT_API_KEY and ERPNEXT_API_SECRET (the project lists both as optional), and Node.js with npm to build the checkout the config points at.
Setup effort
Build from source
USE CASES
01
Answering a question the ERPNext UI will not let you ask
Find which DocTypes the instance has, read the fields on the one you want, then query documents with your own filters and field selection rather than through a report someone built earlier.
02
Entering a document that passes validation first time
The field list says what the record actually accepts before anything is written, and the submit step is separate — a created document is a draft until docstatus moves to 1.
03
Correcting a document that has already been submitted
ERPNext will not let a submitted document be edited, so the sequence is cancel, then create the corrected copy — and deletion only becomes available after the cancel.
04
Pulling a standard report into the conversation
Reports run by name with their filters, and any row worth following up is fetched whole with its child tables and linked data attached.
05
Reaching a Frappe operation the CRUD tools do not name
Any whitelisted server-side method can be called directly with arguments as a JSON body or query parameters, which covers the business logic that lives in methods rather than in documents.
11 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
cancel_document
Cancel a submitted document (set docstatus to 2). Cancelled documents cannot be modified — use amend workflow to create a corrected copy.
create_document
Create a new document in ERPNext
delete_document
Permanently delete a document from ERPNext. This action cannot be undone. Submitted documents must be cancelled before deletion.
get_doctype_fields
Get fields list for a specific DocType
get_doctypes
Get a list of all available DocTypes
get_document
Get a single document by DocType and name, including all child tables and linked data
get_documents
Get a list of documents for a specific doctype
run_report
Run an ERPNext report
submit_document
Submit a document (set docstatus to 1). Only works on submittable doctypes. Submitted documents can only be cancelled, not reverted to draft.
update_document
Update an existing document in ERPNext
BEFORE YOU INSTALL
What to know first
Tools you get
11 tools when we connected.
Requires
- ERPNEXT_API_KEY in your environment
- ERPNEXT_API_SECRET in your environment
Where it runs
Both documented clients run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 11 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
TERMINAL
git clone https://github.com/rakeshgangwar/erpnext-mcp-server
cd erpnext-mcp-server
npm install
npm run buildMCP Clients
Claude Desktop, Cline
JSON
{
"mcpServers": {
"erpnext": {
"command": "node",
"args": [
"<YOUR_PATH_TO_ERPNEXT_SERVER>/build/index.js"
],
"env": {
"ERPNEXT_URL": "<YOUR_ERPNEXT_URL>",
"ERPNEXT_API_KEY": "<YOUR_ERPNEXT_API_KEY>",
"ERPNEXT_API_SECRET": "<YOUR_ERPNEXT_API_SECRET>"
}
}
}
}
