Twenty MCP by usefulapi
Use your Twenty account from Claude, Cursor, or any MCP client โ read people, companies, opportunities, notes and tasks, and create or update CRM records. Hosted,
no local install: connect with your own credentials.
Live endpoint: https://twenty.usefulapi.io/mcp ยท Homepage: https://usefulapi.io
Connect
- Claude (claude.ai, Desktop): open Customize โ Connectors, click + Add โ Add custom connector, and paste
https://twenty.usefulapi.io/mcp.
- Claude Code:
claude mcp add --transport http twenty https://twenty.usefulapi.io/mcp, then run /mcp to log in.
- VS Code: Add to VS Code.
- Cursor and other clients: add the URL as a remote MCP server:
{
"mcpServers": {
"twenty": {
"url": "https://twenty.usefulapi.io/mcp"
}
}
}
Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Twenty credentials.
Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/twenty/
On first connect you'll provide your Twenty API key (Settings โ APIs & Webhooks). It is validated, stored per-user, and scoped to you โ no
keys in config files.
| Tool | Type | What it does |
|---|
twenty_list_metadata_objects | read | List metadata objects |
twenty_list_people | read | List people |
twenty_get_person | read | Get person |
twenty_list_companies | read | List companies |
twenty_get_company | read | Get company |
twenty_list_opportunities | read | List opportunities |
twenty_get_opportunity | read | Get opportunity |
twenty_list_notes | read | List notes |
twenty_get_note | read | Get note |
twenty_list_tasks | read | List tasks |
twenty_get_task | read | Get task |
twenty_create_person | write | Create person |
twenty_update_person | write | Update person |
twenty_create_company | write | Create company |
twenty_update_company | write | Update company |
twenty_create_opportunity | write | Create opportunity |
twenty_update_opportunity | write | Update opportunity |
twenty_create_note | write | Create note |
twenty_create_task | write | Create task |
twenty_update_task | write | Update task |
twenty_usage_status | meta | Usage status (free-tier meter) |
twenty_request_feature | meta | Request a missing feature |
twenty_upgrade | meta | Upgrade to Pro or Pro+ |
twenty_cancel_subscription | meta | Cancel the Pro subscription |
read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.
Pricing
| Plan | Price | Limit |
|---|
| Free | $0 | 50 tool calls / month |
| Pro | $9/mo or $90/yr (2 months free) | Unlimited* |
*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to support@usefulapi.io.
Pro covers this server only. Subscribe with twenty_upgrade (it returns a Stripe Checkout link). Cancel any time with twenty_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running twenty_upgrade before then undoes the cancel. Or write to support@usefulapi.io.
License
MIT โ see LICENSE. Documentation only; the server is hosted.