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

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 sync

Run

set -a && source .env && set +a && uv run erpnext-mcp

Available Tools

MCP Client Configuration

Add to your MCP client config (e.g. Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "erpnext": {
      "command": "uv",
      "args": ["--directory", "/path/to/erpnext-mcp", "run", "erpnext-mcp"],
      "env": {
        "ERPNEXT_URL": "https://your-erpnext-instance.com",
        "ERPNEXT_API_KEY": "your_api_key",
        "ERPNEXT_API_SECRET": "your_api_secret"
      }
    }
  }
}

Project Structure

src/erpnext_mcp/
├── server.py   # MCP tool definitions (FastMCP)
├── client.py   # ERPNext REST API client (httpx async)
└── types.py    # Pydantic models

License

MIT