Pipedrive Mcp Server

Pipedrive MCP サーバー

Binar が開発 — MIT ライセンスのもと、無料でご利用いただけます。

Pipedrive CRM 用の MCP（Model Context Protocol）サーバーです。Claude Code または Claude Desktop を Pipedrive アカウントに直接接続し、自然言語で CRM を管理できます。

"Show me all open deals in the Sales pipeline"
"Create a follow-up call with Acme Corp for tomorrow at 2pm"
"Update John Smith's email address"
"Search for deals related to the enterprise contract"

---

クイックスタート

1. Pipedrive API キーを取得する

1. Pipedrive にログインします
2. Settings → Personal preferences → API に移動します
3. 個人用 API トークンをコピーします

2. Claude Code を設定する

プロジェクトの .mcp.json に追加します。

{
  "mcpServers": {
    "pipedrive": {
      "command": "node",
      "args": ["/path/to/pipedrive-mcp-server/dist/index.js"],
      "env": {
        "PIPEDRIVE_API_KEY": "your-api-token-here"
      }
    }
  }
}

または、Claude Desktop の場合は claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "pipedrive": {
      "command": "node",
      "args": ["/path/to/pipedrive-mcp-server/dist/index.js"],
      "env": {
        "PIPEDRIVE_API_KEY": "your-api-token-here"
      }
    }
  }
}

3. ビルドする

git clone https://github.com/binarapps/pipedrive-mcp-server.git
cd pipedrive-mcp-server
npm install
npm run build

---

利用可能なツール

取引

ツール	説明
pipedrive_list_deals	オーナー、人物、組織、パイプライン、ステージ、ステータスで絞り込んで取引を一覧表示します
pipedrive_get_deal	ID で取引の詳細を取得します
pipedrive_create_deal	新しい取引を作成します
pipedrive_update_deal	既存の取引を更新します
pipedrive_search_deals	タイトル、メモ、またはカスタムフィールドで取引を検索します
pipedrive_delete_deal	取引を削除します
pipedrive_get_deal_emails	取引に紐づくメールスレッドを取得します

人物

ツール	説明
pipedrive_list_persons	絞り込み条件を指定して人物を一覧表示します
pipedrive_get_person	ID で人物の詳細を取得します
pipedrive_create_person	新しい人物を作成します
pipedrive_update_person	名前、メールアドレス、電話番号、組織、カスタムフィールドを更新します
pipedrive_search_persons	名前、メールアドレス、電話番号、カスタムフィールドで検索します
pipedrive_delete_person	人物を削除します
pipedrive_get_person_emails	人物に紐づくメールスレッドを取得します

組織

ツール	説明
pipedrive_list_organizations	絞り込み条件を指定して組織を一覧表示します
pipedrive_get_organization	組織の詳細を取得します
pipedrive_create_organization	新しい組織を作成します
pipedrive_update_organization	既存の組織を更新します
pipedrive_search_organizations	名前、住所、カスタムフィールドで検索します
pipedrive_delete_organization	組織を削除します

アクティビティ

ツール	説明
pipedrive_list_activities	絞り込み条件を指定してアクティビティを一覧表示します
pipedrive_get_activity	アクティビティの詳細を取得します
pipedrive_create_activity	新しいアクティビティ（通話、ミーティング、タスクなど）を作成します
pipedrive_update_activity	アクティビティを更新するか、完了としてマークします
pipedrive_delete_activity	アクティビティを削除します

リード

ツール	説明
pipedrive_list_leads	リードを一覧表示します
pipedrive_get_lead	リードの詳細を取得します
pipedrive_create_lead	新しいリードを作成します
pipedrive_update_lead	リードを更新します
pipedrive_delete_lead	リードを削除します
pipedrive_search_leads	タイトルでリードを検索します

メモ

ツール	説明
pipedrive_list_notes	絞り込み条件を指定してメモを一覧表示します
pipedrive_get_note	メモの詳細を取得します
pipedrive_create_note	新しいメモを作成します
pipedrive_update_note	メモを更新します
pipedrive_delete_note	メモを削除します
pipedrive_list_note_comments	メモへのコメントを一覧表示します
pipedrive_get_note_comment	ID で特定のコメントを取得します
pipedrive_add_note_comment	メモにコメントを追加します
pipedrive_update_note_comment	コメントの内容を更新します
pipedrive_delete_note_comment	メモへのコメントを削除します

メール／メールボックス

ツール	説明
pipedrive_list_mail_threads	フォルダー別にメールスレッドを一覧表示します
pipedrive_get_mail_thread	メールスレッドを取得します
pipedrive_get_mail_thread_messages	スレッド内のすべてのメッセージを取得します
pipedrive_get_mail_message	メッセージ本文全体を取得します
pipedrive_update_mail_thread	スレッドを取引に紐づけ、既読またはアーカイブ済みとしてマークします
pipedrive_delete_mail_thread	メールスレッドを削除します

パイプラインとステージ

ツール	説明
pipedrive_list_pipelines	すべてのパイプラインを一覧表示します
pipedrive_get_pipeline	パイプラインの詳細を取得します
pipedrive_create_pipeline	新しいパイプラインを作成します
pipedrive_update_pipeline	パイプラインを更新します
pipedrive_delete_pipeline	パイプラインを削除します
pipedrive_list_stages	パイプライン内のステージを一覧表示します
pipedrive_get_stage	ステージの詳細を取得します
pipedrive_create_stage	新しいステージを作成します
pipedrive_update_stage	ステージを更新します
pipedrive_delete_stage	ステージを削除します

フィールドのメタデータ

ツール	説明
pipedrive_list_deal_fields	すべての取引フィールド定義（カスタムフィールドを含む）を一覧表示します
pipedrive_list_person_fields	すべての人物フィールド定義を一覧表示します
pipedrive_list_organization_fields	すべての組織フィールド定義を一覧表示します
pipedrive_list_activity_fields	すべてのアクティビティフィールド定義を一覧表示します
pipedrive_list_note_fields	すべてのノートフィールド定義を一覧表示します
pipedrive_list_lead_fields	すべてのリードフィールド定義を一覧表示します
pipedrive_get_field	キーを指定して特定のフィールドを取得します（対応対象：取引、人物、組織、アクティビティ）

ユーザー

ツール	説明
pipedrive_list_users	すべてのユーザーを一覧表示します
pipedrive_get_user	ユーザーの詳細を取得します
pipedrive_get_current_user	現在の API トークンの所有者を取得します
pipedrive_find_users	名前またはメールアドレスでユーザーを検索します

---

API のバージョン管理

Pipedrive は v2 への移行を進めています。このサーバーは、各エンドポイントに適切なバージョンを使用します。

API	エンドポイント
v2 (/api/v2)	取引、人物、組織、アクティビティ、リード（検索）、フィールド、パイプライン、ステージ
v1 (/v1)	リード（CRUD）、ノート、メール／メールボックス、ユーザー

---

ワークフローの例

パイプラインの確認

"Show me all open deals worth over $10k in the Enterprise pipeline"
"Move deal 1234 to the Proposal stage"
"Who owns the most open deals right now?"

連絡先の管理

"Find all contacts at Acme Corp"
"Update John Smith's email to [email protected]"
"Create a new person: Sarah Connor, [email protected], at org 42"

アクティビティの追跡

"List my overdue activities"
"Mark activity 789 as done"
"Create a follow-up meeting with deal 1234 for next Monday"

カスタムフィールド

"List all custom fields defined for deals"
"What does the field with key 'a8f3c2...' mean?"

---

開発

npm install
npm run build      # compile TypeScript
npm run dev        # watch mode
npm test           # run tests

MCP Inspector でテストします：

npx @modelcontextprotocol/inspector node dist/index.js

---

ライセンス

MIT — 自由に使用、変更、配布できます。

---

Binar が ❤️ を込めて開発