Frappe/ERPNext

You can run a dedicated MCP server to assist with Frappe/ERPNext development. This server exposes tools for creating DocTypes, running bench commands, managing apps, and other common Frappe tasks, all accessible through convenient APIs and transports suitable for MCP clients.

How to use

You interact with the MCP server through supported clients. You can use a remote MCP transport over HTTP or run a local stdio-based server that your client connects to directly.

How to use with an MCP client

Set up the server locally and choose a transport that your client supports. The server can expose an HTTP endpoint for remote clients and can also run as a local stdio service for direct client integration.

Starting the server for HTTP transport

The server can be accessed via an HTTP MCP endpoint. Ensure you have built the server and that the transport endpoint is reachable at the given URL.

Starting the server for stdio transport via Claude Desktop

For a Claude Desktop setup on macOS, place the following configuration in your Claude desktop config to connect to the local MCP server using stdio transport.

{
  "mcpServers": {
    "frappe-dev": {
      "command": "node",
      "args": ["/Users/mac/ERPNext/mkahawa/frappe-mcp-server/dist/index.js"],
      "env": {
        "FRAPPE_PATH": "/Users/mac/ERPNext/mkahawa"
      }
    }
  }
}

Starting the server for stdio transport directly

You can run the MCP server directly in stdio mode if you prefer a local startup without a separate client config. Use the following command to start the server, which will listen for stdio connections.

node dist/index.js

Available tools

frappe_create_doctype

Creates a new Frappe DocType with a JSON definition and Python controller.

frappe_run_bench_command

Executes bench commands for Frappe development workflows.

frappe_get_app_structure

Retrieves the directory structure of a Frappe app.

frappe_create_api_endpoint

Creates a custom API endpoint for a Frappe app.

frappe_migrate_database

Runs a database migration for a Frappe site.

frappe_install_app

Installs a Frappe app on a site.

frappe_create_app

Creates a new Frappe app.