Twenty MCP by usefulapi

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.

Tools

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 (unlimited*)
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 [email protected].

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 [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.