mhenry3164/twenty-crm-mcp-server

claude mcp add twenty-crm -e TWENTY_API_KEY=your_api_key_here -e TWENTY_BASE_URL=https://api.twenty.com -- npx -y github:mhenry3164/twenty-crm-mcp-server
git clone https://github.com/mhenry3164/twenty-crm-mcp-server.git && cd twenty-crm-mcp-server && npm install

Usage

• •"List the first 10 people in my CRM"
• •"Create a $12,000 opportunity called 'Acme renewal' in PROPOSAL stage"
• •"Add a note about today's call and attach it to the Acme company record"
• •"Search people, companies and opportunities for 'blockchain'"

Key features

• ✓Complete CRUD and search for people, companies, opportunities, notes, tasks
• ✓Composite-field mapping so flat inputs become Twenty's name/emails/amount/bodyV2 shapes
• ✓Working search via Twenty's real filter grammar (ilike) instead of a nonexistent search param
• ✓Cursor pagination plus raw filter, orderBy and depth passthrough
• ✓Batch creates (up to 60 people or companies per call)
• ✓Schema discovery tools for workspace objects, fields, and enum options
• ✓Resilient client with timeouts, retry/backoff, and structured errors

Best for

Twenty CRM users who want to manage customer data conversationally through Claude or other MCP clients

Caveats

• ⚠Community-supported; maintainer no longer runs Twenty day-to-day
• ⚠Requires a Twenty API key (TWENTY_API_KEY)
• ⚠List max limit is 200 and pagination is cursor-based (no offset)
• ⚠revenue field name varies by Twenty version (annualRecurringRevenue vs annualRevenue)