ERPNext MCP Server
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.
Features
Resources
- Access ERPNext documents via
erpnext://{doctype}/{name}
URIs - JSON format for structured data access
Tools
authenticate_erpnext
- Authenticate with ERPNext using username and passwordget_documents
- Get a list of documents for a specific doctypecreate_document
- Create a new document in ERPNextupdate_document
- Update an existing document in ERPNextrun_report
- Run an ERPNext reportget_doctype_fields
- Get fields list for a specific DocTypeget_doctypes
- Get a list of all available DocTypes
Configuration
The server requires the following environment variables:
ERPNEXT_URL
- The base URL of your ERPNext instanceERPNEXT_API_KEY
(optional) - API key for authenticationERPNEXT_API_SECRET
(optional) - API secret for authentication
Development
Install dependencies:
Build the server:
For development with auto-rebuild:
Installation
To use with Claude Desktop, add the server config:
On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
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.json
On Windows: %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Debugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:
The Inspector will provide a URL to access debugging tools in your browser.
Usage Examples
Authentication
Get Customer List
Get Customer Details
Create New Item
Get Item Fields
This server cannot be installed
A TypeScript-based server that enables AI assistants to interact with ERPNext/Frappe systems through the Model Context Protocol, allowing access to documents, creation/updating of records, and running reports.
Related MCP Servers
- AsecurityAlicenseAqualityA TypeScript server that enhances AI assistants' capabilities when working with Starwind UI components, providing tools for project initialization, component installation, documentation access, and more.Last updated -615TypeScriptMIT License
- -securityFlicense-qualityA TypeScript server that allows AI agents to access, retrieve, and analyze Sentry error data through the Modern Context Protocol.Last updated -2TypeScript
- -securityFlicense-qualityThis 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.Last updated -4JavaScriptMIT License
- -securityFlicense-qualityA TypeScript template for creating Model Context Protocol servers that enable AI models to utilize external tools, including example operations and simple number addition functionality.Last updated -2TypeScript