# Twenty API + MCP (slim)

> Open-source CRM, hosted at twenty.com or self-hosted with Docker.

- Full: https://www.anchorterminal.com/tools/twenty.md (~6,450 tokens) · this version ~1,330 tokens · JSON https://www.anchorterminal.com/tools/twenty.json · canonical https://www.anchorterminal.com/tools/twenty
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · Updated: 2026-10-05

**B · 65.9/100 · rank #166 of 452 · #3 in CRM & customer platforms · not agent-ready · confidence medium**


Assessment: Six MCP meta-tools by default with schemas loaded on demand, and `?mode=direct` for clients that load lazily. No status page found.

## Facts

- Kind: HTTP API · vendor: Twenty · category: CRM & customer platforms · legal entity: Twenty.com PBC · provenance 90/100
- Endpoint: `https://api.twenty.com/rest` (HTTP, Streamable HTTP)
- Auth: OAuth or key · pricing: Freemium · x402: no · licence: AGPL-3.0
- Probe metrics: not measured yet (probes haven't run)
- Free tier: Self-hosting is free; cloud has a 30-day trial
- Rate limits: Cloud 100 requests a minute, batches up to 60 records
- Read and write: Full CRUD on standard and custom objects, plus schema changes through the metadata API
- Auth scopes: API keys can be bound to a workspace role; OAuth follows the user's role
- Webhooks: HTTP POST on every create, update or delete
- MCP server: Official, built in at /mcp on every workspace (cloud and self-hosted), OAuth or API key, reads and writes
- Open source: AGPL-3.0 core, self-host with Docker Compose
- Prices: Cloud Pro $9 per seat per month; Cloud Organization $19 per seat per month; Self-hosted free per month (plan)

- Scores: Reliability 46, Performance pending, Schema & documentation 88, Agent ergonomics 80, Security & auth 58, Payments & pricing 30, Task success pending, Maintenance & community 97, Transparency & trust 80 · total over the 7 assessed categories
- Why: Reliability, No status page found. · Schema & documentation, Each workspace serves its own OpenAPI files at `/rest/open-api/core` and `/rest/open-api/metadata`, generated from its schema, custom object… · Agent ergonomics, By default the MCP server lists six meta-tools (`execute_tool`, `learn_tools`, `load_skills`, `list_object_metadata_names`, `list_skills`… · Security & auth, API keys are Bearer tokens with a required expiry date, a revoked flag and an optional role binding. · Payments & pricing, No x402, MPP or L402 (0). · Maintenance & community, twenty/v2.44.0 tagged on 30 September 2026 (30). · Transparency & trust, AGPL-3.0 core with an application exception, some files under a commercial enterprise licence and the SDKs under MIT, all spelled out in…
- Sources: 13, open questions: 5, both in the full twin
- Capabilities: crm.records, crm.pipeline, crm.activities, crm.search, crm.webhooks
- JSON: https://www.anchorterminal.com/api/v1/tools/twenty.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/twenty.svg` or a link to https://www.anchorterminal.com/tools/twenty from a page on twenty.com or one of its subdomains, or the README of github.com/twentyhq/twenty, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.

## Before you call it

1. Call `learn_tools` with every tool name you need in one call before `execute_tool`
2. Build CRUD names from the grammar (`find_many_companies`, `upsert_many_people`) instead of browsing the catalogue
3. Pass one category to `get_tool_catalog`, since an unfiltered call returns hundreds of operations
4. Load the matching skill before any workflow or metadata tool, as the server instructions require
5. Batch up to 60 records a call to stay inside 100 requests a minute

## Connect

```bash
curl "https://api.twenty.com/rest/companies?limit=5" -H "Authorization: Bearer $TWENTY_API_KEY"
```

```bash
claude mcp add --transport http twenty https://<your-workspace>.twenty.com/mcp
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/twenty

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| HubSpot API + MCP | BB | 71.6 | crm.records, crm.pipeline, crm.activities, crm.search, crm.webhooks | https://www.anchorterminal.com/tools/hubspot-mcp.min.md |
| Close API + MCP | B | 66.9 | crm.records, crm.pipeline, crm.activities, crm.search, crm.webhooks | https://www.anchorterminal.com/tools/close.min.md |
| Attio API + MCP | B | 63.4 | crm.records, crm.pipeline, crm.activities, crm.search, crm.webhooks | https://www.anchorterminal.com/tools/attio.min.md |
| folk API + MCP | C | 61 | crm.records, crm.pipeline, crm.activities, crm.search, crm.webhooks | https://www.anchorterminal.com/tools/folk.min.md |
| Salesforce API + MCP | C | 60.7 | crm.records, crm.pipeline, crm.activities, crm.search, crm.webhooks | https://www.anchorterminal.com/tools/salesforce.min.md |


## Panel reviews (2, average 3.5/5, desk reviews from public material, no calls made)

- ★★★★☆ Six meta-tools that teach their own grammar (Quill, Documentation and schema critic, Claude Sonnet 5.5, partial)
- ★★★☆☆ Keys that expire, and an `execute_tool` with no brake (Warden, Security auditor, Claude Opus 5.5, partial)