Capsule CRM MCP Server

Connect your Capsule CRM data to AI assistants — Access contacts, opportunities, support cases, and more through natural language queries, with complete read-only security.

🚨 Disclaimer: This project is created by Fuzzy Labs with good vibes and is not officially supported by Capsule CRM. Use at your own discretion.

What This Does

Transform how you work with your Capsule CRM data by asking AI assistants natural language questions like:

• “Show me my recent contacts”
• “What opportunities are closing this month?”
• “Find all support cases from last week”
• “List tasks assigned to Sarah”
• “What products do we sell in the UK?”

🔒 Read-Only & Secure — No write access to your CRM data
🚀 Instant Setup — Works with any MCP-compatible AI assistant
📊 Complete Coverage — Access contacts, sales, support, tasks, projects & more

Quick Start

1. Get Your Capsule API Token

1. Log into your Capsule CRM account
2. Go to My Preferences → API Authentication
3. Create a new API token and copy it

2. Install & Configure

macOS Setup

# Install uv (Python package manager)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Clone and install
git clone https://github.com/fuzzylabs/capsule-mcp.git
cd capsule-mcp
uv sync

Linux/Windows Setup

# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh  # Linux/macOS
# OR for Windows: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Clone and install
git clone https://github.com/fuzzylabs/capsule-mcp.git
cd capsule-mcp
uv sync

3. Connect to Your AI Assistant

Claude Desktop

Add this to your Claude Desktop config file:

Config Location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "capsule-crm": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/your/capsule-mcp",
        "python",
        "capsule_mcp/server.py"
      ],
      "env": {
        "CAPSULE_API_TOKEN": "your_capsule_api_token_here"
      }
    }
  }
}

Cursor

📋 Quick Setup:

Copy this Cursor deeplink and paste it in your browser address bar:

cursor://anysphere.cursor-deeplink/mcp/install?name=capsule-crm&config=eyJjYXBzdWxlLWNybSI6eyJjb21tYW5kIjoidXYiLCJhcmdzIjpbInJ1biIsIi0tZGlyZWN0b3J5IiwiL3BhdGgvdG8veW91ci9jYXBzdWxlLW1jcCIsInB5dGhvbiIsImNhcHN1bGVfbWNwL3NlcnZlci5weSJdLCJlbnYiOnsiQ0FQU1VMRV9BUElfVE9LRU4iOiJ5b3VyX2NhcHN1bGVfYXBpX3Rva2VuX2hlcmUifX19