Feature: Create MCP Server for Twenty CRM API Integration

[IgorWarzocha]

Summary

Create a Model Context Protocol (MCP) server that exposes Twenty CRM's GraphQL and REST APIs as MCP tools, enabling AI assistants like Claude to directly interact with CRM data.

Goals

• Enable direct CRM management through Claude Code interface
• Production-ready MVP following Anthropic MCP standards
• Docker deployment with DXT packaging
• Full CRM access (CRUD, workflows, AI features)
• Token-efficient API design

Technical Approach

• Use official MCP TypeScript SDK (@modelcontextprotocol/sdk)
• Hybrid GraphQL + REST API integration
• Containerized deployment
• Multi-tenant workspace support

Implementation Tasks

Based on and :

1. Project Setup - MCP server foundation with TypeScript
2. Authentication - API key integration with Twenty's auth system
3. API Integration - GraphQL and REST clients with connection pooling
4. MCP Tools - CRUD, search, workflow, and AI agent tools
5. Deployment - Docker container with DXT packaging

Acceptance Criteria

• MCP server responds to basic tool calls
• Authentication with Twenty CRM works
• CRUD operations functional for all record types
• Workflow execution through MCP tools
• AI agent integration accessible
• Docker deployment successful
• DXT packaging compliant with Anthropic standards

Related Documents

• PRD:
• Tasks:
• Development: directory created

This implementation leverages Twenty's existing robust API infrastructure to provide seamless AI integration without UI complexity.

[FelixMalfait]

Hey @AMoreaux is working on this, I think it will be pretty quick to build so we'll have something soon :)

[IgorWarzocha]

Thank you for the reply - if I'm being completely honest, this was supposed to live in my personal fork/repo and got uploaded here by mistake :) I was kinda expecting someone to be hard at work on this hah.

[FelixMalfait]

Haha ok no problem! If you have feedback once ours is live, would love to hear it! There are so many ways to build this I'm not sure we're taking the right bet, we'll see!

[erensunerr]

I'd be interested to see once it's ready!

[FelixMalfait]

A basic v1 has been merged on main by @AMoreaux but it's still being feature flag (IS_AI_ENABLED)

I tried things like "create a company and an opportunity based on the following call transcript" and it worked!

[code1704]

how to add twentycrm mcp server to Claude Code? I found https://github.com/IgorWarzocha/twenty-mcp-server and https://github.com/jezweb/twenty-mcp, but neither works.

[FelixMalfait]

@code1704 We have built an official one in the codebase but it's still behing a feature flag (IS_AI_ENABLED). It will be released by end of September

[IgorWarzocha]

how to add twentycrm mcp server to Claude Code? I found https://github.com/IgorWarzocha/twenty-mcp-server and https://github.com/jezweb/twenty-mcp, but neither works.

Hah, I need to hide mine, moved onto other things. I've realised nobody should be releasing or using unofficial MCPs for anything that gets even remotely close to client data. This is disaster waiting to happen.

[code1704]

@code1704 We have built an official one in the codebase but it's still behing a feature flag (IS_AI_ENABLED). It will be released by end of September

Thanks. I've enabled IS_AI_ENABLED and see the 'Ask AI'. How do I add that to claude code?

[code1704]

how to add twentycrm mcp server to Claude Code? I found https://github.com/IgorWarzocha/twenty-mcp-server and https://github.com/jezweb/twenty-mcp, but neither works.

Hah, I need to hide mine, moved onto other things. I've realised nobody should be releasing or using unofficial MCPs for anything that gets even remotely close to client data. This is disaster waiting to happen.

Thanks for your great work. I found some project to build mcp server from openapi spec, e.g. https://github.com/ivo-toby/mcp-openapi-server (not tested yet)

[FelixMalfait]

Thanks. I've enabled IS_AI_ENABLED and see the 'Ask AI'. How do I add that to claude code?

You can check in Settings > Integrations tab you'll find the parameters to set it up