Twenty MCP by usefulapi

io.usefulapi由 usefulapi.io 发布官方发布者v1.36.5更新于 Nov 8, 2026

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

发布方自己的服务:Ably MCP by usefulapi

已验证Streamable HTTP可网页运行效率与工作流商业与电商

概览

AI 生成的概览

面向 Twenty CRM 的托管 MCP 服务器,让助手读取、创建和更新联系人、公司、商机、笔记与任务。

可以做什么
  • 查看 Twenty 架构,发现标准与自定义对象及有效字段名
  • 按筛选、排序、游标分页和关联深度列出并获取联系人、公司、商机、笔记和任务
  • 创建和更新联系人、公司、商机、笔记和任务
  • 查看每月工具调用用量、提交功能请求并管理付费订阅
适用场景
适合希望助手在聊天客户端中查询 Twenty CRM 数据,或直接新增、修改 CRM 记录,又不想在本地安装任何东西的场景。
运行要求
将 twenty.usefulapi.io/mcp 作为远程 MCP 服务器地址添加,无需本地运行时。通过 OAuth 登录,首次连接时需提供 Twenty API 密钥(设置中的 API 与 Webhook),按用户存储。客户端配置中不要填写 API 密钥或 Authorization 头。
安装前请注意
写入类工具会创建和修改 CRM 记录,执行前应先确认。Twenty API 密钥会交给第三方托管方并按用户保存。免费方案每月仅 50 次工具调用;付费方案需付费,通过 Stripe 结账链接订阅,取消时当期不退款。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Twenty MCP by usefulapi,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.usefulapi%2Ftwenty/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "twenty-by-usefulapi": {
      "type": "http",
      "url": "https://twenty.usefulapi.io/mcp"
    }
  }
}

README

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:
json
{  "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

ToolTypeWhat it does
twenty_list_metadata_objectsreadList metadata objects
twenty_list_peoplereadList people
twenty_get_personreadGet person
twenty_list_companiesreadList companies
twenty_get_companyreadGet company
twenty_list_opportunitiesreadList opportunities
twenty_get_opportunityreadGet opportunity
twenty_list_notesreadList notes
twenty_get_notereadGet note
twenty_list_tasksreadList tasks
twenty_get_taskreadGet task
twenty_create_personwriteCreate person
twenty_update_personwriteUpdate person
twenty_create_companywriteCreate company
twenty_update_companywriteUpdate company
twenty_create_opportunitywriteCreate opportunity
twenty_update_opportunitywriteUpdate opportunity
twenty_create_notewriteCreate note
twenty_create_taskwriteCreate task
twenty_update_taskwriteUpdate task
twenty_usage_statusmetaUsage status (free-tier meter)
twenty_request_featuremetaRequest a missing feature
twenty_upgrademetaUpgrade to Pro or Pro+
twenty_cancel_subscriptionmetaCancel 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

PlanPriceLimit
Free$050 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.

来源:servers/twenty/README.md,提交 4046075

工具

20

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.

无需输入参数。

twenty_list_people

List people

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

输入参数depthlimitfilterorder_byending_beforestarting_after

twenty_get_person

Get person

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

输入参数id必填depth

twenty_list_companies

List companies

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

输入参数depthlimitfilterorder_byending_beforestarting_after

twenty_get_company

Get company

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

输入参数id必填depth

twenty_list_opportunities

List opportunities

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

输入参数depthlimitfilterorder_byending_beforestarting_after

twenty_get_opportunity

Get opportunity

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

输入参数id必填depth

twenty_list_notes

List notes

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

输入参数depthlimitfilterorder_byending_beforestarting_after

twenty_get_note

Get note

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

输入参数id必填depth

twenty_list_tasks

List tasks

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

输入参数depthlimitfilterorder_byending_beforestarting_after

twenty_get_task

Get task

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

输入参数id必填depth

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.

输入参数cityxUrlextrajobTitlelastNamecompanyIdfirstNamelinkedinUrlprimaryEmailprimaryPhone

twenty_update_person

Update person

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

输入参数id必填cityxUrlextrajobTitlelastNamecompanyIdfirstNamelinkedinUrlprimaryEmailprimaryPhone

twenty_create_company

Create company

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

输入参数name必填xUrlextraemployeesdomainNameaddressCitylinkedinUrlidealCustomerProfile

twenty_update_company

Update company

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

输入参数id必填namexUrlextraemployeesdomainNameaddressCitylinkedinUrlidealCustomerProfile

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.

输入参数name必填extrastagecloseDatecompanyIdamountMicroscurrencyCodepointOfContactId

twenty_update_opportunity

Update opportunity

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

输入参数id必填nameextrastagecloseDatecompanyIdamountMicroscurrencyCodepointOfContactId

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.

输入参数bodyextratitle必填

twenty_create_task

Create task

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

输入参数bodydueAtextratitle必填statusassigneeId

twenty_update_task

Update task

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

输入参数id必填bodydueAtextratitlestatusassigneeId

版本历史

22
  1. v1.36.5最新Nov 8, 2026
  2. v1.36.4Nov 7, 2026
  3. v1.35.3Nov 5, 2026
  4. v1.35.2Nov 5, 2026
  5. v1.35.1Nov 4, 2026
  6. v1.35.0Nov 3, 2026
  7. v1.34.1Nov 3, 2026
  8. v1.33.0Nov 1, 2026
  9. v1.31.0Oct 31, 2026
  10. v1.30.0Oct 31, 2026
  11. v1.29.2Oct 30, 2026
  12. v1.29.0Oct 30, 2026
  13. v1.24.0Oct 26, 2026
  14. v1.21.3Oct 25, 2026
  15. v1.21.0Oct 25, 2026
  16. v1.20.0Oct 24, 2026
  17. v1.17.0Oct 23, 2026
  18. v1.16.4Oct 22, 2026
  19. v1.16.3Oct 21, 2026
  20. v1.11.1Oct 9, 2026
  21. v1.10.0Oct 9, 2026
  22. v1.0.0Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Usefulapi 集成