ERPNext MCP Server
Provides tools for interacting with the ERPNext REST API, including document CRUD, submit/cancel workflows, reports, DocType schema inspection, inventory and stock queries, item pricing, document conversions, party balances, supplier/customer details, file upload/download, link search, document counts, and generic method calls.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
ERPNext MCP Server
MCP (Model Context Protocol) server for ERPNext REST API, built with FastMCP and Python.
Features
CRUD — List, get, create, update, delete documents
Workflow — Submit and cancel submittable documents
Reports — Run ERPNext query reports
Schema — Inspect DocType field definitions, list all DocTypes
Inventory — Stock balance, stock ledger, item prices
Trading — Document conversion (e.g. Quotation → Sales Order), party balance
Supplier/Customer — Get complete details with address, phone, contacts; supports alias search
Files — Upload, list, download files
Helpers — Link search (autocomplete), document count, generic method calls
Related MCP server: ERPNext MCP Server
Requirements
Python >= 3.11
uv (recommended) or pip
ERPNext instance with API key/secret
Setup
# Clone the repo
git clone <repo-url> && cd erpnext-mcp
# Create .env file
cat > .env << 'EOF'
ERPNEXT_URL=https://your-erpnext-instance.com
ERPNEXT_API_KEY=your_api_key
ERPNEXT_API_SECRET=your_api_secret
EOF
# Install dependencies
uv syncRun
uv run erpnext-mcpThe Streamable HTTP MCP endpoint is available at http://127.0.0.1:8000/mcp
by default. Configure ERPNEXT_MCP_HOST, ERPNEXT_MCP_PORT, and
ERPNEXT_MCP_PATH in .env to change it. For a public deployment, bind to an
appropriate interface and place the service behind an HTTPS reverse proxy.
Available Tools
Tool | Description |
| List documents with filters, sorting, pagination |
| Get a single document by name |
| Create a new document |
| Update an existing document |
| Delete a document |
| Submit a submittable document |
| Cancel a submitted document |
| Execute an ERPNext report |
| Get document count with optional filters |
| List documents with total count |
| Call any whitelisted server-side method |
| Link field autocomplete search |
| List all available DocType names |
| Get field definitions for a DocType |
| Real-time stock balance from Bin (exact item_code) |
| Stock ledger entries (exact item_code) |
| Item prices from price lists (exact item_code) |
| Fuzzy-search Item across name / item_name / item_code |
| Item master + stock + price in one call (supports keyword) |
| Document conversion (e.g. SO → DN) |
| Outstanding balance for Customer/Supplier |
| Get supplier with address, phone, contacts (supports alias search) |
| Get customer with address, phone, contacts (supports alias search) |
| Upload a local file to ERPNext (by file path) |
| Upload a file from URL |
| List files attached to a document |
| Download a file by URL |
| Get download URL for a file |
MCP Client Configuration
Start the server, then add its HTTP endpoint to your MCP client (for example,
Claude Desktop's claude_desktop_config.json):
{
"mcpServers": {
"erpnext": {
"type": "http",
"url": "http://127.0.0.1:8000/mcp"
}
}
}Project Structure
src/erpnext_mcp/
├── server.py # MCP tool definitions (FastMCP)
├── client.py # ERPNext REST API client (httpx async)
└── types.py # Pydantic modelsLicense
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
ERPNext MCP server for ChatGPT, Claude and any AI agent: create sales invoice, submit invoice, create payment entry, list overdue invoices and create customer in your own ERPNext account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to ERPNext yourself; Cotlet does not store your password and you need no ERPNext API key. About the official ERPNext API: Yes. ERPNext has a full REST API (checked 14 Oct 2026): any record, including customers, sales invoices and payment entries, can be listed, created, updated and deleted, and whitelisted methods can be called. Setup and FAQ: https://cotlet.dev/integrations/erpnext-api-mcp-server
Read Bind ERP clients, products, inventory, invoices, orders; create prospects, clients, orders.
Official Akeda ERP connector for tasks, CRM, chats, documents, finance and operations.
Manage Invoice Ninja clients, invoices, quotes, expenses, tasks and projects.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables interaction with Frappe Framework sites through comprehensive document operations, schema introspection, report generation, and method execution. Provides secure API-based access to create, read, update, and delete Frappe documents while supporting financial reporting and DocType management.2417ISC
- AlicenseBqualityDmaintenanceEnables AI assistants to interact with ERPNext/Frappe instances through the REST API, allowing document management, report execution, and DocType operations using natural language.6MIT
- AlicenseBqualityCmaintenanceEnables interaction with ERPNext instances via its REST API to manage documents, inventory, and reports. It supports full CRUD operations, submittable document workflows, and schema inspection through natural language.282MIT
- AlicenseBqualityDmaintenanceIntegrates with ERPNext/Frappe API to enable AI assistants to create, read, update, and list documents, run reports, and authenticate via the Model Context Protocol.6MIT