CiviCRM MCP by usefulapi

usefulapi による CiviCRM MCP

ご自身の CiviCRM を使って、連絡先、寄付、会員資格、イベントを管理し、活動を記録できます。

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

接続

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

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

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

ステップごとの設定方法、認証情報の確認場所、よくある質問：https://usefulapi.io/civicrm/

初回接続時に、CiviCRM のサイトアドレス（例：https://crm.example.org）と、「authenticate with api key」権限を持つ連絡先のAPI キーを入力します。

ツール

ツール	種類	機能
civicrm_whoami	read	現在の連絡先を取得
civicrm_search_contacts	read	連絡先を検索
civicrm_get_contact	read	連絡先を取得
civicrm_list_contact_notes	read	連絡先のメモを一覧表示
civicrm_list_relationships	read	連絡先の関係を一覧表示
civicrm_list_contributions	read	寄付を一覧表示
civicrm_list_memberships	read	会員資格を一覧表示
civicrm_list_events	read	イベントを一覧表示
civicrm_list_participants	read	イベント参加者を一覧表示
civicrm_list_activities	read	活動を一覧表示
civicrm_list_cases	read	ケースを一覧表示
civicrm_list_groups	read	グループを一覧表示
civicrm_list_group_contacts	read	グループメンバーを一覧表示
civicrm_get_fields	read	エンティティのフィールドを説明
civicrm_list_entities	read	API エンティティを一覧表示
civicrm_query	read	任意のエンティティをクエリ
civicrm_create_contact	write	連絡先を作成
civicrm_update_contact	write	連絡先を更新
civicrm_add_contact_note	write	連絡先のメモを追加
civicrm_log_activity	write	活動を記録
civicrm_record_contribution	write	寄付を記録
civicrm_create_membership	write	会員資格を作成
civicrm_add_contact_to_group	write	連絡先をグループに追加
civicrm_register_participant	write	参加者を登録
civicrm_usage_status	meta	利用状況（無料プランの利用枠）
civicrm_request_feature	meta	不足している機能をリクエスト
civicrm_upgrade	meta	Pro にアップグレード（無制限*）
civicrm_cancel_subscription	meta	Pro のサブスクリプションをキャンセル

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

料金

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

*Pro には、このサーバーで月 10,000 回のツール呼び出しという公正利用上限があります。それ以上が必要な場合は、[email protected] までご連絡ください。

Pro の対象はこのサーバーのみです。civicrm_upgrade を使って申し込んでください（Stripe Checkout のリンクが返されます）。civicrm_cancel_subscription でいつでもキャンセルできます。Pro は支払い済み期間の終了まで利用でき、現在の期間分の返金はありません。また、その前に civicrm_upgrade を実行するとキャンセルが取り消されます。[email protected] へのお問い合わせも可能です。

ライセンス

MIT © usefulapi。CiviCRM との提携関係や、CiviCRM による推奨を受けているものではありません。