ERPNext

A Model Context Protocol server for ERPNext integration

This is a TypeScript-based MCP server that provides integration with ERPNext/Frappe API. It enables AI assistants to interact with ERPNext data and functionality through the Model Context Protocol.

- Access ERPNext documents viaerpnext://{doctype}/{name}URIs
- JSON format for structured data access

- get_doctypes- Get a list of all available DocTypes
- get_doctype_fields- Get fields list for a specific DocType
- get_documents- Get a list of documents for a specific doctype
- get_document- Get a single document by name, including all child tables
- create_document- Create a new document in ERPNext
- update_document- Update an existing document in ERPNext
- delete_document- Permanently delete a document
- submit_document- Submit a document (set docstatus to 1)
- cancel_document- Cancel a submitted document (set docstatus to 2)
- call_method- Call an ERPNext/Frappe whitelisted server-side API method
- run_report- Run an ERPNext report

The server requires the following environment variables:

- ERPNEXT_URL- The base URL of your ERPNext instance
- ERPNEXT_API_KEY(optional) - API key for authentication
- ERPNEXT_API_SECRET(optional) - API secret for authentication

To use with Claude Desktop, add the server config:

On MacOS:~/Library/Application Support/Claude/claude_desktop_config.jsonOn Windows:%APPDATA%/Claude/claude_desktop_config.json

{ "mcpServers": { "erpnext": { "command": "node", "args": ["/path/to/erpnext-server/build/index.js"], "env": { "ERPNEXT_URL": "http://your-erpnext-instance.com", "ERPNEXT_API_KEY": "your-api-key", "ERPNEXT_API_SECRET": "your-api-secret" } } } }

To use with Claude in VSCode, add the server config to:

On MacOS:~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.jsonOn Windows:%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using theMCP Inspector, which is available as a package script:

<use_mcp_tool> <server_name>erpnext</server_name> <tool_name>get_documents</tool_name> <arguments> { "doctype": "Customer" } </arguments> </use_mcp_tool>

<access_mcp_resource> <server_name>erpnext</server_name> <uri>erpnext://Customer/CUSTOMER001</uri> </access_mcp_resource>

<use_mcp_tool> <server_name>erpnext</server_name> <tool_name>create_document</tool_name> <arguments> { "doctype": "Item", "data": { "item_code": "ITEM001", "item_name": "Test Item", "item_group": "Products", "stock_uom": "Nos" } } </arguments> </use_mcp_tool>

<use_mcp_tool> <server_name>erpnext</server_name> <tool_name>get_doctype_fields</tool_name> <arguments> { "doctype": "Item" } </arguments> </use_mcp_tool>

A read-only MCP server for querying live SAP ByDesign data. Requires a separate CData JDBC Driver for SAP ByDesign.