Skip to content
MCP server

Twenty MCP by usefulapi

Read people, companies, opportunities, notes and tasks; create and update records in…

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://twenty.usefulapi.io/mcp
Install 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