# Frappe Dev MCP Server

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: SajmustafaKe
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/SajmustafaKe/frappe-dev-mcp-server
- Updated: 2026-06-11
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/frappe-dev-mcp-server

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `FRAPPE_PATH` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env FRAPPE_PATH=<FRAPPE_PATH> --transport stdio frappe-dev-mcp-server -- npx -y frappe-dev-mcp-server
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add frappe-dev-mcp-server --env FRAPPE_PATH=<FRAPPE_PATH> -- npx -y frappe-dev-mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "frappe-dev-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "frappe-dev-mcp-server"
            ],
            "env": {
                "FRAPPE_PATH": "<FRAPPE_PATH>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e FRAPPE_PATH=<FRAPPE_PATH> frappe-dev-mcp-server npx -y frappe-dev-mcp-server
```
Replace <…> with your own values

## When to use it
- 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
- 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

## Similar
- [frappe-agent](https://affpapa.org/en/nevibecode/plugins/frappe-agent.md) — plugin · ★ 1596 repo stars
- [frappe-app-dev](https://affpapa.org/en/nevibecode/skills/frappe-app-dev.md) — skill · 1400 installs
- [frappe-code-review](https://affpapa.org/en/nevibecode/skills/frappe-code-review.md) — skill · 546 installs
- [Pacioli — the ERPNext broker you can hand the books](https://affpapa.org/en/nevibecode/mcp/pacioli-the-erpnext-broker-you-can-hand-the-books.md) — MCP server · ★ 8 repo stars
- [Black Book — Dirt Track Database](https://affpapa.org/en/nevibecode/mcp/black-book-dirt-track-database.md) — MCP server · 342 installs
- [erpnext](https://affpapa.org/en/nevibecode/skills/erpnext.md) — skill · 224 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
