# twenty MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/io-usefulapi-twenty
- Repository: https://github.com/m190/usefulapi-mcp

## Install
- Endpoint: https://twenty.usefulapi.io/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://twenty.usefulapi.io/mcp

## Tools
- twenty_list_metadata_objects (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. Endpoint: https://twenty.usefulapi.io/mcp
- twenty_list_people (List people) - List/filter people (contacts). Supports cursor pagination, raw filter/order_by, and relation depth. Twenty REST: GET /rest/people. Endpoint: https://twenty.usefulapi.io/mcp
- twenty_get_person (Get person) - Get a single person (contact) by id. Twenty REST: GET /rest/people/{id}. Endpoint: https://twenty.usefulapi.io/mcp
- twenty_list_companies (List companies) - List/filter companies. Supports cursor pagination, raw filter/order_by, and relation depth. Twenty REST: GET /rest/companies. Endpoint: https://twenty.usefulapi.io/mcp
- twenty_get_company (Get company) - Get a single company by id. Twenty REST: GET /rest/companies/{id}. Endpoint: https://twenty.usefulapi.io/mcp
- twenty_list_opportunities (List opportunities) - List/filter opportunities (deals). Supports cursor pagination, raw filter/order_by, and relation depth. Twenty REST: GET /rest/opportunities. Endpoint: https://twenty.usefulapi.io/mcp
- twenty_get_opportunity (Get opportunity) - Get a single opportunity by id. Twenty REST: GET /rest/opportunities/{id}. Endpoint: https://twenty.usefulapi.io/mcp
- twenty_list_notes (List notes) - List/filter notes. Supports cursor pagination, raw filter/order_by, and relation depth. Twenty REST: GET /rest/notes. Endpoint: https://twenty.usefulapi.io/mcp
- twenty_get_note (Get note) - Get a single note by id. Twenty REST: GET /rest/notes/{id}. Endpoint: https://twenty.usefulapi.io/mcp
- twenty_list_tasks (List tasks) - List/filter tasks. Supports cursor pagination, raw filter/order_by, and relation depth. Twenty REST: GET /rest/tasks. Endpoint: https://twenty.usefulapi.io/mcp
- twenty_get_task (Get task) - Get a single task by id. Twenty REST: GET /rest/tasks/{id}. Endpoint: https://twenty.usefulapi.io/mcp
- twenty_create_person (Create person) - Create a new person (contact). All fields optional; firstName/lastName combine into name:{firstName,lastName}. Twenty REST: POST /rest/people. Endpoint: https://twenty.usefulapi.io/mcp
- twenty_update_person (Update person) - Update fields on an existing person. Only provided fields change. Twenty REST: PATCH /rest/people/{id}. Endpoint: https://twenty.usefulapi.io/mcp
- twenty_create_company (Create company) - Create a new company. `name` is required. Twenty REST: POST /rest/companies. Endpoint: https://twenty.usefulapi.io/mcp
- twenty_update_company (Update company) - Update fields on an existing company. Only provided fields change. Twenty REST: PATCH /rest/companies/{id}. Endpoint: https://twenty.usefulapi.io/mcp
- twenty_create_opportunity (Create opportunity) - Create a new opportunity (deal). `name` is required; amountMicros combines with currencyCode into amount:{amountMicros,currencyCode}. Twenty REST: POST /rest/opportunities. Endpoint: https://twenty.usefulapi.io/mcp
- twenty_update_opportunity (Update opportunity) - Update fields on an existing opportunity. Only provided fields change. Twenty REST: PATCH /rest/opportunities/{id}. Endpoint: https://twenty.usefulapi.io/mcp
- twenty_create_note (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. Endpoint: https://twenty.usefulapi.io/mcp
- twenty_create_task (Create task) - Create a task. `title` is required. Twenty REST: POST /rest/tasks. Endpoint: https://twenty.usefulapi.io/mcp
- twenty_update_task (Update task) - Update fields on an existing task. Only provided fields change. Twenty REST: PATCH /rest/tasks/{id}. Endpoint: https://twenty.usefulapi.io/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.usefulapi
- Version: 1.0.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Aug 1, 2026
- Source: https://registry.modelcontextprotocol.io