Twenty MCP by usefulapi

Twenty MCP by usefulapi

Claude、Cursor、または任意の MCP クライアントから Twenty アカウントを利用できます。人物、会社、商談、メモ、タスクの読み取りや、CRM レコードの作成・更新が可能です。ホスト型のため、ローカルへのインストールは不要です。ご自身の認証情報で接続できます。

ライブエンドポイント： https://twenty.usefulapi.io/mcp · ホームページ： https://usefulapi.io

接続

• Claude（claude.ai、デスクトップ）：Customize → Connectorsを開き、+ Add → Add custom connectorをクリックして、https://twenty.usefulapi.io/mcpを貼り付けます。
• Claude Code： claude mcp add --transport http twenty https://twenty.usefulapi.io/mcpを実行してから、/mcpを実行してログインします。
• VS Code： VS Code に追加。
• Cursor およびその他のクライアント： URL をリモート MCP サーバーとして追加します。

{
  "mcpServers": {
    "twenty": {
      "url": "https://twenty.usefulapi.io/mcp"
    }
  }
}

URL のみを追加してください。クライアント設定にAuthorizationヘッダーや API キーを追加しないでください。サーバーが OAuth でサインインし、ログインページで Twenty の認証情報を求めます。

手順ごとの設定方法、認証情報の確認方法、よくある質問：https://usefulapi.io/twenty/

初回接続時に、Twenty API キー（Settings → APIs & Webhooks）を入力します。キーは検証され、ユーザーごとに保存され、本人に限定して使用されます。設定ファイルにキーを記載する必要はありません。

ツール

ツール	種類	内容
twenty_list_metadata_objects	読み取り	メタデータオブジェクトの一覧表示
twenty_list_people	読み取り	人物の一覧表示
twenty_get_person	読み取り	人物の取得
twenty_list_companies	読み取り	会社の一覧表示
twenty_get_company	読み取り	会社の取得
twenty_list_opportunities	読み取り	商談の一覧表示
twenty_get_opportunity	読み取り	商談の取得
twenty_list_notes	読み取り	メモの一覧表示
twenty_get_note	読み取り	メモの取得
twenty_list_tasks	読み取り	タスクの一覧表示
twenty_get_task	読み取り	タスクの取得
twenty_create_person	書き込み	人物の作成
twenty_update_person	書き込み	人物の更新
twenty_create_company	書き込み	会社の作成
twenty_update_company	書き込み	会社の更新
twenty_create_opportunity	書き込み	商談の作成
twenty_update_opportunity	書き込み	商談の更新
twenty_create_note	書き込み	メモの作成
twenty_create_task	書き込み	タスクの作成
twenty_update_task	書き込み	タスクの更新
twenty_usage_status	メタ	利用状況（無料プランの使用量）
twenty_request_feature	メタ	不足している機能のリクエスト
twenty_upgrade	メタ	Pro へのアップグレード（無制限*）
twenty_cancel_subscription	メタ	Pro サブスクリプションの解約

readツールは読み取り専用です。writeツールはデータを変更するため、クライアントは実行前に確認する必要があります。metaツールは利用状況の報告、サブスクリプションの管理、機能リクエストの送信を行います。

料金

プラン	料金	上限
Free	$0	月50回のツール呼び出し
Pro	$9/mo または $90/yr（2か月分無料）	無制限*

*Pro には、このサーバーで月10,000回までのフェアユース上限があります。それ以上必要な場合は [email protected] までご連絡ください。

Pro の対象はこのサーバーのみです。twenty_upgradeで登録してください（Stripe Checkout のリンクが返されます）。twenty_cancel_subscriptionでいつでも解約できます。Pro は支払い済み期間の終了まで利用でき、現在の期間分の返金はありません。期間終了前にtwenty_upgradeを実行すると、解約は取り消されます。または [email protected] までご連絡ください。

ライセンス

MIT — LICENSEを参照してください。ドキュメントのみです。サーバーはホストされています。