Frappe CRM MCP Server

Connect your AI tools to Frappe CRM using the Model Context Protocol.

Once connected, your AI assistants can interact with your CRM data:

• "Show me all open deals"
• "Create a lead for John at Acme Corp"
• "What's happening with the Tesla deal?"
• "Add a note to the Stripe deal about our call today"

Prerequisites

1. A Frappe CRM instance (cloud or self-hosted)
2. API credentials (see Generate API Keys)
3. Python 3.11+ and uv (for local installation)

Installation

Claude Code

claude mcp add frappe-crm \
  -e FRAPPE_URL=https://your-site.frappe.cloud \
  -e FRAPPE_API_KEY=your_api_key \
  -e FRAPPE_API_SECRET=your_api_secret \
  -- uvx frappe-crm-mcp

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "frappe-crm": {
      "command": "uvx",
      "args": ["frappe-crm-mcp"],
      "env": {
        "FRAPPE_URL": "https://your-site.frappe.cloud",
        "FRAPPE_API_KEY": "your_api_key",
        "FRAPPE_API_SECRET": "your_api_secret"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "frappe-crm": {
      "command": "uvx",
      "args": ["frappe-crm-mcp"],
      "env": {
        "FRAPPE_URL": "https://your-site.frappe.cloud",
        "FRAPPE_API_KEY": "your_api_key",
        "FRAPPE_API_SECRET": "your_api_secret"
      }
    }
  }
}

Windsurf

Add to your Windsurf MCP config:

{
  "mcpServers": {
    "frappe-crm": {
      "command": "uvx",
      "args": ["frappe-crm-mcp"],
      "env": {
        "FRAPPE_URL": "https://your-site.frappe.cloud",
        "FRAPPE_API_KEY": "your_api_key",
        "FRAPPE_API_SECRET": "your_api_secret"
      }
    }
  }
}

Generate API Keys

1. Log into your Frappe CRM instance
2. Go to User → your user → API Access
3. Click Generate Keys
4. Copy the API Key and API Secret (secret is only shown once)

Available Tools

Development

git clone https://github.com/joehaddad2000/frappe-crm-mcp.git
cd frappe-crm-mcp
uv sync

# Run with environment variables
FRAPPE_URL=... FRAPPE_API_KEY=... FRAPPE_API_SECRET=... uv run frappe-crm-mcp

License

MIT