Frappe Dev MCP Server — Claude Code MCP server: what it does
Frappe Dev MCP Server is a Claude Code MCP server that streamlines Frappe/ERPNext development tasks. The tool integrates with AI agents to manage DocTypes, run bench commands, and build APIs.
MIT ★ 5 updated 2026-06-11
claude mcp add --env FRAPPE_PATH=<FRAPPE_PATH> --transport stdio frappe-dev-mcp-server -- npx -y frappe-dev-mcp-serverWhat Frappe Dev MCP Server does
This MCP server enables AI assistance for key development workflows within the Frappe ecosystem. It handles generating DocType JSON definitions, executing database migrations, and providing insights into app directory structures directly through agent commands.
To operate the server, you must have Node.js 18 or newer installed on your machine. Access to a functional Frappe bench environment is required for all commands. You must define the FRAPPE_PATH environment variable pointing to your specific bench directory to ensure the server can locate your projects.
Setup varies depending on the client; for Claude Desktop, you must add the server definition to claude_desktop_config.json with the correct path. Without a valid FRAPPE_PATH, the server may fail to execute development commands on your local files.
What it helps with
- generate JSON definitions for DocTypes
- execute bench commands for project workflows
- create custom API endpoints with Python code
- analyze the directory structure of an app
Example prompts for the agent
- Create a new DocType using frappe_create_doctype
- Run a migration on the current site with frappe_run_bench_command
- List the structure of my app using frappe_get_app_structure
How to install Frappe Dev MCP Server
Platform CLI
claude mcp add --env FRAPPE_PATH=<FRAPPE_PATH> --transport stdio frappe-dev-mcp-server -- npx -y frappe-dev-mcp-serverReplace <…> with your own values
Platform CLI
codex mcp add frappe-dev-mcp-server --env FRAPPE_PATH=<FRAPPE_PATH> -- npx -y frappe-dev-mcp-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"frappe-dev-mcp-server": {
"command": "npx",
"args": [
"-y",
"frappe-dev-mcp-server"
],
"env": {
"FRAPPE_PATH": "<FRAPPE_PATH>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"frappe-dev-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"frappe-dev-mcp-server"
],
"env": {
"FRAPPE_PATH": "<FRAPPE_PATH>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e FRAPPE_PATH=<FRAPPE_PATH> frappe-dev-mcp-server npx -y frappe-dev-mcp-serverReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Frappe Dev MCP Server
How to install Frappe Dev MCP Server in Claude Code?
Run claude mcp add --env FRAPPE_PATH=<FRAPPE_PATH> --transport stdio frappe-dev-mcp-server -- npx -y frappe-dev-mcp-server, replacing <FRAPPE_PATH> with your actual bench directory path.
What does Frappe Dev MCP Server do?
It bridges Frappe/ERPNext development tools with AI agents, enabling automated creation of DocTypes, execution of bench commands, and database management.
What is required to use Frappe Dev MCP Server?
You need Node.js 18+, a working Frappe/ERPNext bench environment, and the FRAPPE_PATH environment variable set to your bench directory.