Hey everyone,
I built an MCP (Model Context Protocol) server for ERPNext that connects any AI agent (Claude, GPT, or custom) directly to your ERPNext instance via the standard Frappe REST API.
Demo video
What it does
- 120 tools across 13 categories (Sales, Inventory, Purchasing, Accounting, HR, CRM, Manufacturing, Projects, Assets, Delivery, Analytics, Setup, Generic CRUD)
- 7 interactive UI viewers (charts, KPIs, kanban pipeline, invoices, stock balance, sales funnel)
- 19 analytics tools with built-in chart rendering
- Works with any ERPNext instance via API key authentication
- Supports stdio (Claude Desktop, Claude Code) and HTTP mode
- Category filtering — load only what you need:
--categories=sales,inventory - Zero dependencies — single self-contained npm bundle
Install (Claude Desktop / Claude Code)
{
"mcpServers": {
"erpnext": {
"command": "npx",
"args": ["-y", "@casys/mcp-erpnext"],
"env": {
"ERPNEXT_URL": "http://localhost:8000",
"ERPNEXT_API_KEY": "your-api-key",
"ERPNEXT_API_SECRET": "your-api-secret"
}
}
}
}
Also available on JSR for Deno.
Some things you can do out of the box
- “Show me all overdue invoices” → gets the data + renders a chart
- “Create a sales order for customer X with items Y and Z” → done
- “What’s my stock level for item ABC?” → stock balance with color-coded badges
- “Show me revenue trend by month” → interactive line chart
- “Create a quotation and email it” → creates the doc in ERPNext
Links
- npm: https://www.npmjs.com/package/@casys/mcp-erpnext
- Source: https://github.com/Casys-AI/AgentCards (lib/erpnext)
Feedback welcome. MIT licensed.
