Name: Twenty
Author: usefulapi

Twenty MCP

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

Tool-list grade A Remote · Streamable HTTP No auth needed 20 tools v1.11.1

No reviews yet by usefulapiGitHub The publisher’s own endpoint — this marketplace is not in the path

93/100

tool-list score

tools declared

remote

at its publisher

—

calls last 7d

What it does

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

Quickstart

# 1 — add it to Claude Code
claude mcp add --scope user --transport http twenty-mcp https://twenty.usefulapi.io/mcp

# 2 — ask your agent for something these tools do
#   twenty_list_metadata_objects, twenty_list_people, twenty_get_person and 17 more

Twenty costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.

Publishernot claimed

usefulapi334 servers

24 categories

All 334 servers

Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.

Tool surface

What the model actually sees. Descriptions are diffed on every release — see version history.

Only tools that write or reach the network

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.

No parameter schema on file.

List/filter people (contacts). Supports cursor pagination, raw filter/order_by, and relation depth. Twenty REST: GET /rest/people.

Parameter	Type	Required	Notes
limit	integer	no	Results per page (1-60, default 20 — Twenty caps at 60).
starting_after	string	no	Pagination cursor — return records after this cursor (from a previous page's pageInfo).
ending_before	string	no	Pagination cursor — return records before this cursor (from a previous page's pageInfo).
filter	string	no	Raw Twenty filter string, passed verbatim as ?filter=. Syntax: field[comparator]:value, e.g. employees[gte]:100 or stage[eq]:"MEETING". Comparators: eq, neq, gt, gte, lt, lte, in, is, like, ilike,
order_by	string	no	Raw Twenty ordering string, passed verbatim as ?order_by=, e.g. createdAt[DescNullsLast].
depth	integer	no	How deep to hydrate related records: 0, 1, or 2.

Get a single person (contact) by id. Twenty REST: GET /rest/people/{id}.

Parameter	Type	Required	Notes
id	string	yes	The person id.
depth	integer	no	How deep to hydrate related records: 0, 1, or 2.

List/filter companies. Supports cursor pagination, raw filter/order_by, and relation depth. Twenty REST: GET /rest/companies.

Parameter	Type	Required	Notes
limit	integer	no	Results per page (1-60, default 20 — Twenty caps at 60).
starting_after	string	no	Pagination cursor — return records after this cursor (from a previous page's pageInfo).
ending_before	string	no	Pagination cursor — return records before this cursor (from a previous page's pageInfo).
filter	string	no	Raw Twenty filter string, passed verbatim as ?filter=. Syntax: field[comparator]:value, e.g. employees[gte]:100 or stage[eq]:"MEETING". Comparators: eq, neq, gt, gte, lt, lte, in, is, like, ilike,
order_by	string	no	Raw Twenty ordering string, passed verbatim as ?order_by=, e.g. createdAt[DescNullsLast].
depth	integer	no	How deep to hydrate related records: 0, 1, or 2.

Get a single company by id. Twenty REST: GET /rest/companies/{id}.

Parameter	Type	Required	Notes
id	string	yes	The company id.
depth	integer	no	How deep to hydrate related records: 0, 1, or 2.

List/filter opportunities (deals). Supports cursor pagination, raw filter/order_by, and relation depth. Twenty REST: GET /rest/opportunities.

Parameter	Type	Required	Notes
limit	integer	no	Results per page (1-60, default 20 — Twenty caps at 60).
starting_after	string	no	Pagination cursor — return records after this cursor (from a previous page's pageInfo).
ending_before	string	no	Pagination cursor — return records before this cursor (from a previous page's pageInfo).
filter	string	no	Raw Twenty filter string, passed verbatim as ?filter=. Syntax: field[comparator]:value, e.g. employees[gte]:100 or stage[eq]:"MEETING". Comparators: eq, neq, gt, gte, lt, lte, in, is, like, ilike,
order_by	string	no	Raw Twenty ordering string, passed verbatim as ?order_by=, e.g. createdAt[DescNullsLast].
depth	integer	no	How deep to hydrate related records: 0, 1, or 2.

Get a single opportunity by id. Twenty REST: GET /rest/opportunities/{id}.

Parameter	Type	Required	Notes
id	string	yes	The opportunity id.
depth	integer	no	How deep to hydrate related records: 0, 1, or 2.

List/filter notes. Supports cursor pagination, raw filter/order_by, and relation depth. Twenty REST: GET /rest/notes.

Parameter	Type	Required	Notes
limit	integer	no	Results per page (1-60, default 20 — Twenty caps at 60).
starting_after	string	no	Pagination cursor — return records after this cursor (from a previous page's pageInfo).
ending_before	string	no	Pagination cursor — return records before this cursor (from a previous page's pageInfo).
filter	string	no	Raw Twenty filter string, passed verbatim as ?filter=. Syntax: field[comparator]:value, e.g. employees[gte]:100 or stage[eq]:"MEETING". Comparators: eq, neq, gt, gte, lt, lte, in, is, like, ilike,
order_by	string	no	Raw Twenty ordering string, passed verbatim as ?order_by=, e.g. createdAt[DescNullsLast].
depth	integer	no	How deep to hydrate related records: 0, 1, or 2.

Get a single note by id. Twenty REST: GET /rest/notes/{id}.

Parameter	Type	Required	Notes
id	string	yes	The note id.
depth	integer	no	How deep to hydrate related records: 0, 1, or 2.

List/filter tasks. Supports cursor pagination, raw filter/order_by, and relation depth. Twenty REST: GET /rest/tasks.

Parameter	Type	Required	Notes
limit	integer	no	Results per page (1-60, default 20 — Twenty caps at 60).
starting_after	string	no	Pagination cursor — return records after this cursor (from a previous page's pageInfo).
ending_before	string	no	Pagination cursor — return records before this cursor (from a previous page's pageInfo).
filter	string	no	Raw Twenty filter string, passed verbatim as ?filter=. Syntax: field[comparator]:value, e.g. employees[gte]:100 or stage[eq]:"MEETING". Comparators: eq, neq, gt, gte, lt, lte, in, is, like, ilike,
order_by	string	no	Raw Twenty ordering string, passed verbatim as ?order_by=, e.g. createdAt[DescNullsLast].
depth	integer	no	How deep to hydrate related records: 0, 1, or 2.

Get a single task by id. Twenty REST: GET /rest/tasks/{id}.

Parameter	Type	Required	Notes
id	string	yes	The task id.
depth	integer	no	How deep to hydrate related records: 0, 1, or 2.

Create a new person (contact). All fields optional; firstName/lastName combine into name:{firstName,lastName}. Twenty REST: POST /rest/people.

Parameter	Type	Required	Notes
firstName	string	no	First name (combined into name:{firstName,lastName}).
lastName	string	no	Last name (combined into name:{firstName,lastName}).
jobTitle	string	no	Job title.
city	string	no	City.
primaryEmail	string	no	Primary email address (sent as emails:{primaryEmail}).
primaryPhone	string	no	Primary phone number (sent as phones:{primaryPhoneNumber}).
companyId	string	no	Id of the company to link this person to.
linkedinUrl	string	no	LinkedIn URL (sent as linkedinLink:{primaryLinkUrl}).
xUrl	string	no	X/Twitter URL (sent as xLink:{primaryLinkUrl}).
extra	object	no	Passthrough object of additional/custom fields merged into the request body verbatim.

Update fields on an existing person. Only provided fields change. Twenty REST: PATCH /rest/people/{id}.

Parameter	Type	Required	Notes
id	string	yes	The person id to update.
firstName	string	no	First name (combined into name:{firstName,lastName}).
lastName	string	no	Last name (combined into name:{firstName,lastName}).
jobTitle	string	no	Job title.
city	string	no	City.
primaryEmail	string	no	Primary email address (sent as emails:{primaryEmail}).
primaryPhone	string	no	Primary phone number (sent as phones:{primaryPhoneNumber}).
companyId	string	no	Id of the company to link this person to.
linkedinUrl	string	no	LinkedIn URL (sent as linkedinLink:{primaryLinkUrl}).
xUrl	string	no	X/Twitter URL (sent as xLink:{primaryLinkUrl}).
extra	object	no	Passthrough object of additional/custom fields merged into the request body verbatim.

Create a new company. name is required. Twenty REST: POST /rest/companies.

Parameter	Type	Required	Notes
name	string	yes	The company name (required).
domainName	string	no	Primary domain / website URL (sent as domainName:{primaryLinkUrl}).
employees	number	no	Employee count.
addressCity	string	no	City (sent as address:{addressCity}).
idealCustomerProfile	boolean	no	Whether this company matches the ideal customer profile.
linkedinUrl	string	no	LinkedIn URL (sent as linkedinLink:{primaryLinkUrl}).
xUrl	string	no	X/Twitter URL (sent as xLink:{primaryLinkUrl}).
extra	object	no	Passthrough object of additional/custom fields merged into the request body verbatim.

Update fields on an existing company. Only provided fields change. Twenty REST: PATCH /rest/companies/{id}.

Parameter	Type	Required	Notes
id	string	yes	The company id to update.
name	string	no	The company name.
domainName	string	no	Primary domain / website URL (sent as domainName:{primaryLinkUrl}).
employees	number	no	Employee count.
addressCity	string	no	City (sent as address:{addressCity}).
idealCustomerProfile	boolean	no	Whether this company matches the ideal customer profile.
linkedinUrl	string	no	LinkedIn URL (sent as linkedinLink:{primaryLinkUrl}).
xUrl	string	no	X/Twitter URL (sent as xLink:{primaryLinkUrl}).
extra	object	no	Passthrough object of additional/custom fields merged into the request body verbatim.

Create a new opportunity (deal). name is required; amountMicros combines with currencyCode into amount:{amountMicros,currencyCode}. Twenty REST: POST /rest/opportunities.

Parameter	Type	Required	Notes
name	string	yes	The opportunity name (required).
amountMicros	number	no	Opportunity amount in micros (× 1,000,000). Sent as amount:{amountMicros,currencyCode}.
currencyCode	string	no	Currency code for the amount (default USD; only sent when amountMicros is provided).
stage	string	no	Pipeline stage — e.g. SCREENING, MEETING, PROPOSAL, NEGOTIATION, CUSTOMER (custom pipelines vary).
closeDate	string	no	Expected close date (ISO 8601).
companyId	string	no	Id of the associated company.
pointOfContactId	string	no	Id of the point-of-contact person.
extra	object	no	Passthrough object of additional/custom fields merged into the request body verbatim.

Update fields on an existing opportunity. Only provided fields change. Twenty REST: PATCH /rest/opportunities/{id}.

Parameter	Type	Required	Notes
id	string	yes	The opportunity id to update.
name	string	no	The opportunity name.
amountMicros	number	no	Opportunity amount in micros (× 1,000,000). Sent as amount:{amountMicros,currencyCode}.
currencyCode	string	no	Currency code for the amount (default USD; only sent when amountMicros is provided).
stage	string	no	Pipeline stage — e.g. SCREENING, MEETING, PROPOSAL, NEGOTIATION, CUSTOMER (custom pipelines vary).
closeDate	string	no	Expected close date (ISO 8601).
companyId	string	no	Id of the associated company.
pointOfContactId	string	no	Id of the point-of-contact person.
extra	object	no	Passthrough object of additional/custom fields merged into the request body verbatim.

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.

Parameter	Type	Required	Notes
title	string	yes	The note title (required).
body	string	no	The note content/body.
extra	object	no	Passthrough object of additional/custom fields merged into the request body verbatim.

Create a task. title is required. Twenty REST: POST /rest/tasks.

Parameter	Type	Required	Notes
title	string	yes	The task title (required).
body	string	no	Task body / description.
status	string	no	Task status — e.g. TODO, IN_PROGRESS, DONE.
dueAt	string	no	Due date/time (ISO 8601).
assigneeId	string	no	Id of the workspace member assigned to the task.
extra	object	no	Passthrough object of additional/custom fields merged into the request body verbatim.

Update fields on an existing task. Only provided fields change. Twenty REST: PATCH /rest/tasks/{id}.

Parameter	Type	Required	Notes
id	string	yes	The task id to update.
title	string	no	The task title.
body	string	no	Task body / description.
status	string	no	Task status — e.g. TODO, IN_PROGRESS, DONE.
dueAt	string	no	Due date/time (ISO 8601).
assigneeId	string	no	Id of the workspace member assigned to the task.
extra	object	no	Passthrough object of additional/custom fields merged into the request body verbatim.

Free

$0 forever

Every tool — any call limit is its publisher’s, not ours
No card, and mcprush charges nothing for it
Runs at its publisher’s own address — this marketplace is not in the path
Nothing to cap, because mcprush bills nothing

Nothing here is billable: mcprush charges nothing to install Twenty or to call it, at any volume.

ATool-list grade · score 93 / 100

Release 1.11.1 · scanned 20 Oct 2026

Graded from the tools this server lists, not from its source code.

Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.

Threat score100

Client score93

Findings0 threat · 0 capability

Capabilitymoderate

Coveragemanifest

Verificationnot in this report

Surface digest1f1456f6a1e6921a10fe1845548b56f2ddc90c7902f99a9b658177e12e17d2ea

Score vectorthreat 100 → client 93

Term	Level	What it prices	Points
capability-exposure	moderate	capability blast radius (moderate) — client exposure if the model is manipulated	−3
coverage-honesty	manifest	inspection depth (manifest) — how much of the target the scan could see	−4

score = clamp(round(threatScore − E_cap − E_ver − E_cov), 0, 100). No model, no opinion, no network call at scoring time: the same methodology version against the same bytes always produces this number, and every line above is a field of the report rather than a summary of it.

What the scan could actually read

A grade is only as meaningful as its coverage, so the scanner publishes its own depth before it publishes its result.

The scan read each tool’s name, description, input schema and annotations exactly as the server listed them the last time it answered us; no code was reviewed. We ask the server again about once a month, and a list that changed is graded again.

Tool surfaceread

Implementation sourcenot available

Package metadatanot available

Live transportnot available

The implementation source was not read — this reflects the declared tool metadata only.

Capability — what it could do if the model were manipulated

Tags derived from each tool’s schema and the implementation, not from what the tool calls itself. moderate is the level these add up to.

Tool	Capability tags	Why the tag was assigned
twenty_list_metadata_objects	no tags
twenty_list_people	no tags
twenty_get_person	no tags
twenty_list_companies	no tags
twenty_get_company	no tags
twenty_list_opportunities	no tags
twenty_get_opportunity	no tags
twenty_list_notes	no tags
twenty_get_note	no tags
twenty_list_tasks	no tags
twenty_get_task	no tags
twenty_create_person	state-write	state-write: declares destructiveHint: true
twenty_update_person	state-write	state-write: declares destructiveHint: true
twenty_create_company	state-write	state-write: declares destructiveHint: true
twenty_update_company	state-write	state-write: declares destructiveHint: true
twenty_create_opportunity	state-write	state-write: declares destructiveHint: true
twenty_update_opportunity	state-write	state-write: declares destructiveHint: true
twenty_create_note	state-write	state-write: declares destructiveHint: true
twenty_create_task	state-write	state-write: declares destructiveHint: true
twenty_update_task	state-write	state-write: declares destructiveHint: true

Toxic-flow graph

The lethal trifecta, checked as a graph rather than as a checklist: untrusted input, a sensitive source and an external sink have to meet before there is a path worth worrying about.

The public result for this release does not print the flow graph, so there is nothing to show here. That is not the same as "no paths were found": what the scan did read is above, under coverage.

Supply chain and provenance

Integrityfirst-seen

Surface digest1f1456f6a1e6921a

Scanned2026-10-20

This is the first scan of this surface here, so there is nothing yet to compare it against.

Every result on this tab comes from one deterministic pass over the published package — offline, rule by rule, and auditable line by line above. Same methodology version, same bytes, same score.

Where are you running it?

Tool surface

Release history

Twenty MCP

What it does

Quickstart

Where are you running it?

Tool surface

What counts against your monthly calls

What the scan could actually read

Capability — what it could do if the model were manipulated

Toxic-flow graph

Supply chain and provenance

Release history

See also