erpnext-mcp-server

Overview

This MCP server provides comprehensive integration between AI assistants and ERPNext business management systems. It exposes tools for creating, reading, updating, and deleting documents, as well as executing custom API methods and reports. The server uses the official Frappe API to securely connect to ERPNext instances, supporting both resource-based document access and direct tool calls for various operations. TypeScript implementation ensures type safety while the clean architecture makes it easy to extend functionality.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• get_doctypes

  Get a list of all available DocTypes

  Try:List all doctypes in ERPNextTry:Show me available document types
• get_doctype_fields

  Get fields list for a specific DocType

  Try:What fields are available in the Customer doctype?Try:Show me the Item doctype fields
• get_documents

  Get a list of documents for a specific doctype

  Try:List all customersTry:Get all Sales Orders
• get_document

  Get a single document by name, including all child tables

  Try:Retrieve customer details for CUSTOMER001Try:Get the sales order SO-2023-001
• create_document

  Create a new document in ERPNext

  Try:Create a new customer named Test CustomerTry:Add a new Item with code ITEM001
• update_document

  Update an existing document in ERPNext

  Try:Update customer CUSTOMER001 with new emailTry:Change the item name of ITEM001
• delete_document

  Permanently delete a document

  Try:Delete customer CUSTOMER001Try:Remove sales order SO-2023-001
• submit_document

  Submit a document (set docstatus to 1)

  Try:Submit the sales order SO-2023-001Try:Mark the invoice INV-001 as submitted
• cancel_document

  Cancel a submitted document (set docstatus to 2)

  Try:Cancel the sales order SO-2023-001Try:Mark the invoice INV-001 as cancelled
• call_method

  Call an ERPNext/Frappe whitelisted server-side API method

  Try:Run the method to recalculate stock levelsTry:Execute the custom update customer status method
• run_report

  Run an ERPNext report

  Try:Run the sales summary report for Q1 2023Try:Execute the stock valuation report

Comparable tools

Installation

npm install

npm run build

{
  "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"
      }
    }
  }
}

FAQ

What ERPNext versions are supported?

This server uses the official Frappe API which is compatible with most recent ERPNext versions.

How is authentication handled?

Authentication is handled via API key and/or secret passed through environment variables.

Compare erpnext-mcp-server with