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 整合