Twenty MCP Server

io.usefulapi/twenty

answering

Twenty is answering right now. Last checked 11 min ago. It exposes 20 tools. Last commit 1 Aug 2026.

Read people, companies, opportunities, notes and tasks; create and update records in Twenty CRM.

Uptime history 39 hours of history · worst hour 0%

39 hours agonow

34.1%

Uptime 24h

31 of 91 checks

Tools

read from the server

184 ms

Response time

average over 24h

Stars

last commit 1 Aug 2026

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 11 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add twenty --transport http https://twenty.usefulapi.io/mcp

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "twenty": {
      "url": "https://twenty.usefulapi.io/mcp"
    }
  }
}

~/.codex/config.toml

[mcp_servers.twenty]
url = "https://twenty.usefulapi.io/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "twenty": {
      "url": "https://twenty.usefulapi.io/mcp"
    }
  }
}

.vscode/mcp.json

{
  "mcpServers": {
    "twenty": {
      "url": "https://twenty.usefulapi.io/mcp"
    }
  }
}

Available tools 20

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

twenty

twenty_create_company

Create a new company. `name` is required. Twenty REST: POST /rest/companies.

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_opportunity

Create a new opportunity (deal). `name` is required; amountMicros combines with currencyCode into amount:{amountMicros,currencyCode}. Twenty REST: POST /rest/opportunities.

twenty_create_person

Create a new person (contact). All fields optional; firstName/lastName combine into name:{firstName,lastName}. Twenty REST: POST /rest/people.

twenty_create_task

Create a task. `title` is required. Twenty REST: POST /rest/tasks.

twenty_get_company

Get a single company by id. Twenty REST: GET /rest/companies/{id}.

twenty_get_note

Get a single note by id. Twenty REST: GET /rest/notes/{id}.

twenty_get_opportunity

Get a single opportunity by id. Twenty REST: GET /rest/opportunities/{id}.

twenty_get_person

Get a single person (contact) by id. Twenty REST: GET /rest/people/{id}.

twenty_get_task

Get a single task by id. Twenty REST: GET /rest/tasks/{id}.

twenty_list_companies

List/filter companies. Supports cursor pagination, raw filter/order_by, and relation depth. Twenty REST: GET /rest/companies.

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_notes

List/filter notes. Supports cursor pagination, raw filter/order_by, and relation depth. Twenty REST: GET /rest/notes.

twenty_list_opportunities

List/filter opportunities (deals). Supports cursor pagination, raw filter/order_by, and relation depth. Twenty REST: GET /rest/opportunities.

twenty_list_people

List/filter people (contacts). Supports cursor pagination, raw filter/order_by, and relation depth. Twenty REST: GET /rest/people.

twenty_list_tasks

List/filter tasks. Supports cursor pagination, raw filter/order_by, and relation depth. Twenty REST: GET /rest/tasks.

twenty_update_company

Update fields on an existing company. Only provided fields change. Twenty REST: PATCH /rest/companies/{id}.

twenty_update_opportunity

Update fields on an existing opportunity. Only provided fields change. Twenty REST: PATCH /rest/opportunities/{id}.

twenty_update_person

Update fields on an existing person. Only provided fields change. Twenty REST: PATCH /rest/people/{id}.

twenty_update_task

Update fields on an existing task. Only provided fields change. Twenty REST: PATCH /rest/tasks/{id}.

Endpoints

URL	Transport	State	Latency	Checked
https://twenty.usefulapi.io/mcp	streamable-http	answering	214 ms	11 min ago

Twenty — questions

Answers built from our own checks of this server.

What can Twenty do?

It exposes 20 tools, read directly from the server on our last check. Among them: twenty_create_company, twenty_create_note, twenty_create_opportunity, twenty_create_person, twenty_create_task, twenty_get_company and 14 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is Twenty working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 31 of 91 checks got a reply (34.1%), average response time 184 ms. The bar chart above shows every period we have measured.

How do I connect Twenty?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Twenty need an API key?

No. Twenty completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 20 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is Twenty?

It answers our handshake in 184 ms on average, which is faster than 66% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.

Is Twenty open source?

Yes — it is published under the MIT licence, written in JavaScript and 0 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.