Twenty Crm MCP Server
Twenty CRM data orchestration via full CRUD, search, and schema discovery tools.
Data last scanned today · Reviewed today
Overview
This server bridges the gap between your AI assistant and your Twenty CRM instance. It translates natural language requests into the specific API operations required to manage people, companies, opportunities, notes, and tasks within the CRM platform. The server features advanced input handling, such as converting flat fields into Twenty's composite data shapes and using native filter grammar for accurate data retrieval. It also includes resilience features like automatic request retries and standardized error reporting to maintain connectivity.
Our verdict
With a security score of 35/100, this server is currently rated at high risk. The lack of granular permission controls means any installation grants full write access to your CRM data, and the absence of OAuth support necessitates careful handling of your API key. Given it is a community-maintained project rather than an official vendor release, it is best suited for sandbox environments or users who have independently verified the codebase for their specific operational needs.
- Supports full CRUD operations for core CRM objects
- Implements resilient client logic with automatic retries
- Features native Twenty CRM filter grammar for search
- Maps flat inputs to complex composite CRM data fields
- Requires full write access for every installation
- Lacks OAuth support for restricted API scoping
- Maintained by community contributors rather than the official vendor
Setup
{
"mcpServers": {
"twenty-crm-mcp-server": {
"args": [
"-y",
"twenty-crm-mcp-server"
],
"command": "npx"
}
}
}Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.
- No read-only mode — running this grants full read/write access.
- No built-in authentication — anyone with access to this config can invoke every tool it exposes.
Tools
| Tool | Description | Risk |
|---|---|---|
| create_person | Creates a new person record. | medium |
| get_person | Retrieves details of a specific person. | low |
| update_person | Updates an existing person record. | medium |
| list_people | Lists people records with optional filters and pagination. | low |
| delete_person | Deletes a person record. | high |
| create_company | Creates a new company record. | medium |
| get_company | Retrieves details of a specific company. | low |
| update_company | Updates an existing company record. | medium |
| list_companies | Lists company records with optional filters and pagination. | low |
| delete_company | Deletes a company record. | high |
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf | ||||
| ChatGPT |
Frequently asked questions
›What are the system requirements for running this MCP server?
You must have Node.js version 18 or higher installed on your machine.
›How do I authenticate the connection to my Twenty CRM instance?
You need to generate an API key from your Twenty CRM settings under Developers, then provide it via the TWENTY_API_KEY environment variable.
›Can I use this server with a self-hosted Twenty CRM instance?
Yes, you can configure the server for self-hosted instances by setting the TWENTY_BASE_URL environment variable to your specific instance URL.
›How does the server handle composite data fields like names and emails?
The server accepts flat input parameters and automatically maps them into the complex object shapes required by the Twenty CRM API.
›Are custom fields supported?
Yes, custom fields pass through to the CRM untouched, and you can use the metadata tools to discover your workspace's specific object structures.
›What is the limitation for batch record creation?
The server supports batch creation of up to 60 people or company records per API call.
Badge
Maintain this server? Add the live badge to your README.