# Twenty MCP by usefulapi

> Twenty MCP by usefulapi is an MCP server. Read people, companies, opportunities, notes and tasks; create and update records in Twenty CRM. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/twenty/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/twenty
- **MCP Registry name:** io.usefulapi/twenty
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://twenty.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "twenty": {
      "type": "http",
      "url": "https://twenty.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "twenty": {
      "serverUrl": "https://twenty.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "twenty": {
      "type": "http",
      "url": "https://twenty.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `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}.

## 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

---
Source: https://ai-powered.com/mcp/twenty-mcp-by-usefulapi
