MCP server
Twenty MCP by usefulapi
Read people, companies, opportunities, notes and tasks; create and update records in…
- Runs
- Remotely
- Version
- 1.40.0
- Listing updated
- 4 days ago
About Twenty MCP by usefulapi
Twenty MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Read people, companies, opportunities, notes and tasks; create and update records in Twenty CRM.
Install
Run in a terminal
claude mcp add --transport http twenty https://twenty.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://twenty.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"twenty": {
"url": "https://twenty.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"twenty": {
"type": "http",
"url": "https://twenty.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"twenty": {
"serverUrl": "https://twenty.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"twenty": {
"type": "http",
"url": "https://twenty.usefulapi.io/mcp"
}
}
}Tools this server provides (20)
Read directly from the server.
- twenty_list_metadata_objects
- List all objects (standard + custom) and their fields from the Twenty schema — use this to discover custom objects/fields and valid field names. Twenty REST: GET /rest/metadata/objects.
- twenty_list_people
- List/filter people (contacts). Supports cursor pagination, raw filter/order_by, and relation depth. Twenty REST: GET /rest/people.
- twenty_get_person
- Get a single person (contact) by id. Twenty REST: GET /rest/people/{id}.
- twenty_list_companies
- List/filter companies. Supports cursor pagination, raw filter/order_by, and relation depth. Twenty REST: GET /rest/companies.
- twenty_get_company
- Get a single company by id. Twenty REST: GET /rest/companies/{id}.
- twenty_list_opportunities
- List/filter opportunities (deals). Supports cursor pagination, raw filter/order_by, and relation depth. Twenty REST: GET /rest/opportunities.
- twenty_get_opportunity
- Get a single opportunity by id. Twenty REST: GET /rest/opportunities/{id}.
- twenty_list_notes
- List/filter notes. Supports cursor pagination, raw filter/order_by, and relation depth. Twenty REST: GET /rest/notes.
- twenty_get_note
- Get a single note by id. Twenty REST: GET /rest/notes/{id}.
- twenty_list_tasks
- List/filter tasks. Supports cursor pagination, raw filter/order_by, and relation depth. Twenty REST: GET /rest/tasks.
- twenty_get_task
- Get a single task by id. Twenty REST: GET /rest/tasks/{id}.
- twenty_create_person
- Create a new person (contact). All fields optional; firstName/lastName combine into name:{firstName,lastName}. Twenty REST: POST /rest/people.
- twenty_update_person
- Update fields on an existing person. Only provided fields change. Twenty REST: PATCH /rest/people/{id}.
- twenty_create_company
- Create a new company. `name` is required. Twenty REST: POST /rest/companies.
- twenty_update_company
- Update fields on an existing company. Only provided fields change. Twenty REST: PATCH /rest/companies/{id}.
- twenty_create_opportunity
- Create a new opportunity (deal). `name` is required; amountMicros combines with currencyCode into amount:{amountMicros,currencyCode}. Twenty REST: POST /rest/opportunities.
- twenty_update_opportunity
- Update fields on an existing opportunity. Only provided fields change. Twenty REST: PATCH /rest/opportunities/{id}.
- twenty_create_note
- Create a note. `title` is required; `body` holds the note content. (Attaching to records via noteTargets is out of scope.) Twenty REST: POST /rest/notes.
- twenty_create_task
- Create a task. `title` is required. Twenty REST: POST /rest/tasks.
- twenty_update_task
- Update fields on an existing task. Only provided fields change. Twenty REST: PATCH /rest/tasks/{id}.
Twenty MCP by usefulapi FAQ
How do I add Twenty MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http twenty https://twenty.usefulapi.io/mcp