twenty-crm

Twenty CRM MCP Server exposes a GraphQL-native bridge to your Twenty CRM instance, enabling natural-language interactions via Claude and other MCP clients. It supports full CRUD across core CRM objects (people, companies, opportunities, tasks, and notes), handles composite fields (names, emails, phones, addresses, links), and provides real-time updates with synchronization to Twenty. The server is TypeScript-based with strong type definitions and includes practical examples for creating, querying, updating, and linking records as well as timeline activities and attachments. With the provided MCP interface, you can issue natural-language commands like creating a contact, listing opportunities, updating a company address, or attaching files, all translated into precise GraphQL operations against Twenty CRM. To use it, configure Claude Desktop (or another MCP client) with the MCP server entry, supply your Twenty CRM API key and base URL, and then send natural-language prompts that map to CRM actions.

Prerequisites:\n- Node.js 18 or higher\n- A Twenty CRM instance (self-hosted or cloud)\n- Claude Desktop or a compatible MCP client\n\nOption 1: Install via npm (Recommended)\n1. Get your Twenty CRM API key from Settings → API & Webhooks (Developers) and copy it.\n2. Configure Claude Desktop with the MCP server entry (example below).\n3. Restart Claude Desktop.\n\nOption 2: Install from Source\n1. Clone the repository:\nbash\ngit clone https://github.com/KonstiDoll/twenty-crm-mcp-server.git\ncd twenty-crm-mcp-server\n\n2. Install dependencies:\nbash\nnpm install\n\n3. Build the project:\nbash\nnpm run build\n\n4. Get your Twenty CRM API key as above.\n5. Configure Claude Desktop to point at the built server (see two configurations below).\n\nClaude Desktop configuration (npm/npx variant):\njson\n{\n "mcpServers": {\n "twenty-crm": {\n "command": "npx",\n "args": ["-y", "twenty-crm-mcp-server"],\n "env": {\n "TWENTY_API_KEY": "your_api_key_here",\n "TWENTY_BASE_URL": "https://api.twenty.com"\n }\n }\n }\n}\n\nClaude Desktop configuration (built server variant):\njson\n{\n "mcpServers": {\n "twenty-crm": {\n "command": "node",\n "args": ["/absolute/path/to/twenty-crm-mcp-server/dist/index.js"],\n "env": {\n "TWENTY_API_KEY": "your_api_key_here",\n "TWENTY_BASE_URL": "https://api.twenty.com"\n }\n }\n }\n}\n\n\nRestart Claude Desktop after configuring.

Tips and common issues:\n- Ensure TWENTY_API_KEY has permissions to access the necessary resources in Twenty CRM.\n- If using a self-hosted Twenty instance, set TWENTY_BASE_URL to your base API URL.\n- The MCP server relies on Node.js; ensure the runtime matches your deployment environment.\n- When upgrading, rebuild the project (npm run build) to pick up changes.\n- Use the provided examples in the README as templates for crafting natural-language prompts that map to specific GraphQL operations.\n- For large data operations, consider batching or pagination where applicable.\n- Check Twenty CRM’s rate limits and adjust request cadence accordingly to avoid throttling.\n- Ensure network access between Claude Desktop and your Twenty CRM instance, especially in self-hosted setups or VPNs.