Pipedrive CRM

Pipedrive MCP サーバー

Claude Code や Claude Desktop と連携して Pipedrive CRM を統合する MCP（Model Context Protocol）サーバーです。AI アシスタントから CRM データを直接検索、作成、更新できます。

このサーバーを選ぶ理由

• API v2 を優先。 各エンティティには、対応する場合は Pipedrive の v2 REST API を使用します。v1 は v2 に相当する機能がない場合（ノート、メール、ユーザー、リードの CRUD）にのみ使用します。API バージョンをご覧ください。
• 実際の OpenAPI 仕様に対するコントラクトテスト済み。 リクエストパラメーター、リクエストボディ、レスポンス形式を、tests/contract/ 内で同梱されている Pipedrive OpenAPI v2 定義（docs/api/openapi-v2.yaml）と照合しています。そのため、v2 ツールが文書化された API から気づかないうちに逸脱することはありません。
• 実環境でスモークテスト済み。 実際の Pipedrive アカウントに対してツール全体を幅広くテストしています（scripts/smoke-coverage.ts）。API からデータを投入できない対象（メールスレッドやプロジェクトテンプレートなど）のみ、手動確認が必要です。Growth+ の取引分割払いなど、プランで制限されるエンドポイントも対象です（scripts/smoke-installments.ts）。主要な書き込みスモークテスト（タスクの is_done フラグなど）では、単に 200 が返ることではなく、実際にフィールド値が変更されたことを通信上で確認します。
• サーバー側で機能モードを適用。 PIPEDRIVE_MODE で安全性の段階を選択します。read-only、safe-write（デフォルト。読み取りと非破壊的な書き込み）、または full を指定できます。モード外のツールは tools/list に表示されず、直接呼び出された場合も拒否されます。削除、変換、その他の不可逆な書き込み（ツール一覧で 🔒 が付いたもの）には full が必要なため、初期設定では読み取りと作成のみが可能です。すべてのツールには MCP アノテーション（readOnlyHint／destructiveHint／idempotentHint）も付いており、ポリシー対応クライアントは読み取り、書き込み、削除を判別できます。機能モードをご覧ください。
• MIT ライセンスで、npm ビルドの来歴情報を付けて公開しています。

制限事項について。 現時点でトランスポートは STDIO のみです（Streamable HTTP フラグは今後追加予定）。認証には Pipedrive API キーを使用しており、このサーバーが対象とするローカル／セルフホスト可能な環境に適しています。ホスト型 OAuth はまだ提供していません。

機能

• CRM の全般的な操作：取引、人物、組織、アクティビティ
• メール分析：エンゲージメント分析のためにメールスレッドとメッセージにアクセス
• フィールドの特定：カスタムフィールドのハッシュコードを人が読める名前に対応付け
• パイプライン管理：パイプライン、ステージ、ユーザーを一覧表示
• ページネーション対応：大規模なデータセット向けのカーソルベースのページネーション
• エラー処理：明確で、対処方法が分かるエラーメッセージ

クイックスタート

最速のセットアップ：npx … init

1 つのコマンドでガイド付きインストーラーを実行し、プロンプトに従ってください。Pipedrive の API トークンページを開き、アカウントに対してキーをリアルタイムで検証してから、クライアント（Claude Desktop、Claude Code、Cursor、Windsurf、または VS Code）用の動作する MCP 設定を生成します。

npx -y @ckalima/pipedrive-mcp-server init

貼り付け可能なブロックを必ず表示し、タイムスタンプ付きのバックアップを作成したうえで、必要に応じてクライアントの設定ファイルに書き込むこともできます。コミットまたは共有する設定ファイルでは、生のキーを使わず、${PIPEDRIVE_API_KEY} を介して参照します。手動で設定したい場合は、以下の手順も引き続き利用できます。

1. Pipedrive API キーを取得する

1. Pipedrive にログインします
2. Settings > Personal preferences > API の順に移動します
3. API キー（40 文字）をコピーします

2. Claude Code を設定する

.mcp.json ファイルに追加します。

{
  "mcpServers": {
    "pipedrive": {
      "command": "npx",
      "args": ["-y", "@ckalima/pipedrive-mcp-server"],
      "env": {
        "PIPEDRIVE_API_KEY": "your-40-character-api-key"
      }
    }
  }
}

パッケージ名： 対応しているパッケージは、スコープ付きの @ckalima/pipedrive-mcp-server です。スコープなしの pipedrive-mcp-server を参照する古い設定例を見ている場合は、上記のスコープ付きの名前に設定を更新してください。スコープなしの名前は、別の無関係なパッケージです。

次のコマンドを直接実行して、設定を確認することもできます。

npx -y @ckalima/pipedrive-mcp-server

または、環境変数を設定します。

export PIPEDRIVE_API_KEY="your-40-character-api-key"

環境変数

変数	必須	デフォルト	説明
PIPEDRIVE_API_KEY	はい	-	40 文字の Pipedrive API トークンです。
PIPEDRIVE_MODE	いいえ	safe-write	サーバーが適用する機能レベルです。read-only（読み取りのみ）、safe-write（読み取りと非破壊的な書き込み）、full（破壊的な操作を含むすべてのツール）を指定します。モードの対象外のツールは tools/list から非表示になり、直接呼び出された場合も拒否されます。認識された値が設定されている場合はその値が優先されます。空白の値は未設定として扱われ（デフォルトが適用されます）、認識されない値の場合は read-only にフォールバックします。機能モードを参照してください。
PIPEDRIVE_ENABLE_DESTRUCTIVE	いいえ	false	レガシーフラグです。PIPEDRIVE_MODE によって置き換えられました。PIPEDRIVE_MODE が未設定の場合、true は full として扱われ、それ以外は safe-write として扱われます。後方互換性のため、引き続き有効です。PIPEDRIVE_MODE=full の使用を推奨します。
PIPEDRIVE_IMAGE_BASE_DIR	いいえ	（未設定）	file_path が画像アップロードツールに渡された場合に、サーバーが商品画像を読み取れる許可リスト対象のディレクトリです。これを設定しない限り、ファイルシステムからの読み取りは無効で、file_path はこのディレクトリ内を指す必要があります。呼び出し元がサーバーのファイルシステムを共有できない場合は、未設定のまま base64_data を渡してください。SECURITY.mdを参照してください。

破壊的なツールを有効にするには、.mcp.json の env ブロックで PIPEDRIVE_API_KEY とともに PIPEDRIVE_MODE=full（または後方互換性のため PIPEDRIVE_ENABLE_DESTRUCTIVE=true）を設定します。full より低いモードでは、すべての 🔒 ツールが実行する代わりに DESTRUCTIVE_DISABLED エラーを返し、現在のレベルを超えるツールは MODE_RESTRICTED エラーを返します。

機能モード

PIPEDRIVE_MODE は、サーバーが適用する安全レベルを設定します。このレベルは 2 つの方法で適用されます。モードの対象外のツールは tools/list から除外されるため、エージェントに表示されません。また、ディスパッチャーはハンドラーの実行前に、名前によって対象外の呼び出しを拒否します。そのため、このレベルは UI 上のヒントではなく、実際に保証される制限です。

モード	利用できる機能	ツール数	破壊的な操作
read-only	読み取り操作のみ（list／get／search）	69	いいえ
safe-write	読み取りと非破壊的な書き込み	123	いいえ
full	すべてのツール	155	はい

初回の設定とエージェントの評価には、read-only を推奨します。 エージェントが何かに触れる前に確認できるようにしてから、信頼度に応じてレベルを引き上げてください。

後方互換性。 PIPEDRIVE_MODE が設定されている場合は、その値が優先されます。未設定の場合、モードはレガシーの PIPEDRIVE_ENABLE_DESTRUCTIVE フラグから決定されます（true → full、それ以外 → safe-write）。そのため、既存のインストールではアップグレード後も、実行時の動作が維持されます。以前実行できたツールは引き続き実行でき、以前制限されていたツールは引き続き制限されます。未設定時のデフォルト（safe-write）で変わるのは、実行時には有効化されない限りすでに拒否されていた 32 個の破壊的なツールが、tools/list に表示された後で拒否されるのではなく、tools/list からも非表示になる点です（そのため、表示されるツール数は 155 ではなく 123 です）。認識されない PIPEDRIVE_MODE の値は read-only にフォールバックします。

3. 使い始める

設定が完了すると、Claude は Pipedrive のデータにアクセスできます。

• 「1 万ドルを超える未成立の案件を表示して」
• 「金額 5 万ドルの『Acme Contract』という案件を作成して」
• 「TechCorp のすべての連絡先を検索して」
• 「受信トレイの最近のメールスレッドを一覧表示して」
• 「案件にはどのようなカスタムフィールドが定義されていますか？」

接続済みアカウント

API トークンによって、どの Pipedrive 企業に接続するかが決まりますが、これまではツールの結果に接続先の企業が示されていませんでした。同じクライアントでこのサーバーを 2 つ登録している場合（たとえば、プロジェクトスコープのエントリーと、古い .env を読み込むローカルスコープのエントリー）、それぞれ異なる企業に解決され、優先順位で負けた方は見えません。サーバーは、実際に解決したアカウントを 2 か所で通知するようになりました。

起動時に、stderr に 1 行表示します。

[pipedrive-mcp-server] Connected as [email protected] -> company "Example Corp" (id 12345)

確認に失敗した場合、サーバーが何も通知せずに起動する代わりに、その行にその旨が表示されます（Could not verify connected account: ...）。API キーがない、または形式が正しくない場合は、リクエストが行われていないため、アカウントを確認できなかったことが報告されます。

起動時の確認が完了した後の最初のツール応答には、同じ企業を示す connection ブロックが一度だけ含まれます。これにより、エージェントは尋ねたりツール呼び出しを消費したりせずに、データの取得元となったアカウントを把握できます。これはプロセスごとに一度だけ出力されます。確認はバックグラウンドで実行されるため、確認中に完了したツール呼び出しは変更されずに返され、ブロックは後続の応答に含まれます。すべての初期応答に必ず含まれる保証ではなく、サーバーが把握した時点で一度通知する情報として扱ってください。また、配信されることと利用されることは別です。ブロックをそのまま渡すホストであっても、それに基づいて行動するかどうかはモデル次第であり、小型のモデルでは実行によっては無視されることがあります。

このブロック内の company_id と verified はサーバーが保証する値で、トップレベルに置かれます。サーバーが保証できない表示文字列（company_name と user_email、確認に成功しなかった場合の reason）は untrusted_display の下にネストされます。企業名は、アカウントへの書き込み権限を持つ誰もが設定できる CRM コンテンツだからです。このブロックを解析する場合、このキーの下にあるすべての値を data と同じ信頼レベルとして扱ってください。SECURITY.md を参照してください。

この確認では、起動時に GET /v1/users/me を 1 回だけ実行し、タイムアウトは 10 秒です。起動を妨げることも、ツール呼び出しを失敗させることもありません。期待値との照合は行いません。verified: true が意味するのは、トークンが何らかのアカウントに解決されたということであり、正しいアカウントに解決されたということではありません。

同じ情報を必要なときに取得するには、pipedrive_get_current_user を呼び出してください。接続中の企業の名前、ID、ドメインと、トークン所有者のユーザー詳細が返されます。

コントリビューター向け： バナーの行と通知には、どちらも実際の Pipedrive 企業 ID が含まれます。どちらかをこのリポジトリ内のドキュメントに貼り付ける場合、そのドキュメントは公開ツリーではなく、Git で無視される docs/private/ に置いてください（CLAUDE.md を参照）。

利用可能なツール

155 個のツール。 🔒 破壊的操作（PIPEDRIVE_MODE=full が必要。デフォルトでは無効） · ⭑ Growth 以上のプランが必要です。有効なケイパビリティモードによって、一覧表示されるツールが決まります。

_{このセクションは、ライブのツールレジストリから npm run gen:docs によって生成されます。手動で編集しないでください。差分があると CI が失敗します。}

商談

ツール	説明
pipedrive_list_deals	Pipedrive の商談を一覧表示します。担当者、人物、組織、パイプライン、ステージ、ステータスで絞り込むこともできます。ページ分けされた結果を返します。
pipedrive_get_deal	ID を指定して特定の商談の詳細情報を取得します。標準フィールドとカスタムフィールドがすべて含まれます。
pipedrive_create_deal	Pipedrive に新しい商談を作成します。タイトルのみ必須で、その他のフィールドはすべて任意です。
pipedrive_update_deal	Pipedrive の既存の商談を更新します。商談 ID と更新するフィールドを指定します。
pipedrive_search_deals	タイトル内のテキストで商談を検索します。デフォルトであいまい検索に対応しています。
pipedrive_delete_deal 🔒	商談を削除します。商談は削除済みとしてマークされ、30 日後に完全に削除されます。
pipedrive_list_deal_followers	商談のフォロワーをすべて一覧表示します。
pipedrive_add_deal_follower	商談にフォロワーを追加します。
pipedrive_delete_deal_follower 🔒	商談からフォロワーを削除します。
pipedrive_get_deal_followers_changelog	商談のフォロワー変更履歴を取得します。
pipedrive_list_deal_products	商談に紐付けられた明細商品を一覧表示します。ページ分けされた結果を返します。
pipedrive_add_deal_product	商品を 1 つ、明細として商談に紐付けます。
pipedrive_update_deal_product	商談に紐付けられた明細商品を更新します。本文のフィールドはすべて任意です。
pipedrive_delete_deal_product 🔒	商談から明細商品を削除します。
pipedrive_bulk_add_deal_products	1 回のリクエストで、明細商品を最大 100 件まとめて商談に追加します。
pipedrive_list_deal_discounts	商談に適用された追加割引をすべて一覧表示します。
pipedrive_add_deal_discount	商談に追加割引を追加します。
pipedrive_update_deal_discount	商談の追加割引を更新します。ID 以外のフィールドはすべて任意です。
pipedrive_delete_deal_discount 🔒	商談から追加割引を削除します。
pipedrive_list_deal_installments ⭑	1 件以上の商談の分割払いを一覧表示します。deal_ids が必要です。Growth 以上のプランが必要です。
pipedrive_add_deal_installment ⭑	商談に分割払い（支払いスケジュールの項目）を追加します。Growth 以上のプランが必要です。また、商談には一括払いの商品が 1 つ以上あり、継続課金の商品がない必要があります。
pipedrive_update_deal_installment ⭑	商談の分割払いを更新します。Growth 以上のプランが必要です。本文のフィールドはすべて任意です。
pipedrive_delete_deal_installment 🔒 ⭑	商談から分割払いを削除します。Growth 以上のプランが必要です。
pipedrive_list_archived_deals	アーカイブ済みの商談を、アクティブな商談一覧と同じ条件（担当者、人物、組織、パイプライン、ステージ、ステータス）で絞り込んで一覧表示します。ページ分けされた結果を返します。
pipedrive_convert_deal_to_lead 🔒	商談をリードに変換します（非同期ジョブ）。破壊的操作：変換が成功すると、元の商談は削除済みとしてマークされます。conversion_id を返します。変換は非同期で実行されるため、conversion_id を指定して pipedrive_get_deal_conversion_status を終端ステータスになるまでポーリングする必要があります。PIPEDRIVE_MODE=full が必要です（後方互換性のため、PIPEDRIVE_ENABLE_DESTRUCTIVE=true も使用できます）。
pipedrive_get_deal_conversion_status	商談からリードへの変換ジョブのステータスを取得します。ステータスの仕様：'completed'（終端。lead_id を含む）、'failed'/'rejected'（終端。ポーリングを停止し、リードは生成されません）、'not_started'/'running'（処理中。再度ポーリングします）。lead_id を含むのは 'completed' のみです。変換ステータスは数日後に消去されるため、有効なステータスを以前に取得した後で 404 が返された場合は、ステータスが消去されたことを意味します（ポーリングを終了するシグナルであり、一時的なエラーではありません）。ポーリング回数には上限を設け（例：短いバックオフを挟んで最大約 6 回）、無制限にループしないでください。

人物

ツール	説明
pipedrive_list_persons	Pipedrive の人物（連絡先）を一覧表示します。担当者、組織、または名前の頭文字による絞り込みを任意で指定できます。
pipedrive_get_person	ID を指定して、特定の人物の詳細情報を取得します。
pipedrive_create_person	Pipedrive に新しい人物（連絡先）を作成します。名前のみ必須です。
pipedrive_update_person	Pipedrive の既存の人物を更新します。
pipedrive_search_persons	名前、メールアドレス、または電話番号で人物を検索します。
pipedrive_delete_person 🔒	人物を削除します。人物は削除済みとしてマークされ、30 日後に完全に削除されます。
pipedrive_list_person_followers	人物のフォロワーをすべて一覧表示します。
pipedrive_add_person_follower	人物にフォロワーを追加します。
pipedrive_delete_person_follower 🔒	人物からフォロワーを削除します。
pipedrive_get_person_followers_changelog	人物のフォロワー変更履歴を取得します。
pipedrive_get_person_picture	人物の画像を取得します（読み取り専用。画像のメタデータとサイズ別の画像 URL を返します）。人物に画像がない場合はエラーを返します。

組織

ツール	説明
pipedrive_list_organizations	Pipedrive の組織を一覧表示します。担当者、または名前の頭文字による絞り込みを任意で指定できます。
pipedrive_get_organization	ID を指定して、特定の組織の詳細情報を取得します。
pipedrive_create_organization	Pipedrive に新しい組織を作成します。名前のみ必須です。
pipedrive_update_organization	Pipedrive の既存の組織を更新します。
pipedrive_search_organizations	名前または住所で組織を検索します。
pipedrive_delete_organization 🔒	組織を削除します。組織は削除済みとしてマークされ、30 日後に完全に削除されます。
pipedrive_list_organization_followers	組織のフォロワーをすべて一覧表示します。
pipedrive_add_organization_follower	組織にフォロワーを追加します。
pipedrive_delete_organization_follower 🔒	組織からフォロワーを削除します。
pipedrive_get_organization_followers_changelog	組織のフォロワー変更履歴を取得します。

アクティビティ

ツール	説明
pipedrive_list_activities	Pipedrive のアクティビティを一覧表示します。担当者、案件、人物、組織、種類、または完了状況による絞り込みを任意で指定できます。
pipedrive_get_activity	ID を指定して、特定のアクティビティの詳細情報を取得します。
pipedrive_create_activity	Pipedrive に新しいアクティビティを作成します。件名と種類が必須です。
pipedrive_update_activity	Pipedrive の既存のアクティビティを更新します。アクティビティを完了としてマークする場合に使用します。
pipedrive_delete_activity 🔒	アクティビティを削除します。

メモ

ツール	説明
pipedrive_list_notes	Pipedrive のメモを一覧表示します。案件、人物、組織、またはリードによる絞り込みを任意で指定できます。
pipedrive_get_note	ID を指定して、特定のメモの詳細情報を取得します。
pipedrive_create_note	Pipedrive に新しいメモを作成します。内容が必須です。案件、人物、組織、またはリードにリンクします。
pipedrive_update_note	Pipedrive の既存のメモを更新します。
pipedrive_delete_note 🔒	メモを削除します。

リード

ツール	説明
pipedrive_list_leads	Pipedrive の有効な（アーカイブされていない）リードを一覧表示します。オーナー、人物、または組織で絞り込むこともできます。
pipedrive_list_archived_leads	Pipedrive のアーカイブ済みリードを一覧表示します。オーナー、人物、または組織で絞り込むこともできます。
pipedrive_get_lead	UUID を指定して、特定のリードの詳細情報を取得します。
pipedrive_create_lead	Pipedrive に新しいリードを作成します。タイトルは必須です。また、person_id または organization_id の少なくとも一方に関連付ける必要があります。
pipedrive_update_lead	Pipedrive の既存のリードを更新します。
pipedrive_search_leads	Pipedrive でタイトルまたは関連する連絡先からリードを検索します。
pipedrive_delete_lead 🔒	リードを削除します。PIPEDRIVE_MODE=full が必要です（後方互換性のため、PIPEDRIVE_ENABLE_DESTRUCTIVE=true も使用できます）。
pipedrive_convert_lead_to_deal 🔒	リードを案件に変換します（Pipedrive v2）。破壊的操作：変換が成功すると、変換元のリードは削除済みになります。変換は非同期で実行され、このツールは完了するまでポーリングします（通常は 5 秒未満）。新しい案件 ID が返されます。約 30 秒後も処理中の場合は、手動で確認できるよう conversion_id とステータスが返されます。PIPEDRIVE_MODE=full が必要です（後方互換性のため、PIPEDRIVE_ENABLE_DESTRUCTIVE=true も使用できます）。
pipedrive_get_lead_conversion_status	conversion ID を指定して、非同期のリードから案件への変換ステータスを取得します（Pipedrive v2 GET /leads/{id}/convert/status/{conversion_id}）。

プロジェクト

ツール	説明
pipedrive_list_projects	Pipedrive のプロジェクトを一覧表示します。ボード、フェーズ、またはステータスで絞り込むこともできます。ページ分割された結果を返します。（Projects アドオンが必要です。Projects API はパブリックベータ版です。）
pipedrive_get_project	ID を指定して、特定のプロジェクトの詳細情報を取得します。（Projects アドオンが必要です。Projects API はパブリックベータ版です。）
pipedrive_create_project	Pipedrive に新しいプロジェクトを作成します。title、board_id、phase_id が必要です。（Projects アドオンが必要です。Projects API はパブリックベータ版です。）
pipedrive_update_project	Pipedrive の既存のプロジェクトを更新します。（Projects アドオンが必要です。Projects API はパブリックベータ版です。）
pipedrive_delete_project 🔒	プロジェクトを削除します。PIPEDRIVE_MODE=full が必要です（後方互換性のため、PIPEDRIVE_ENABLE_DESTRUCTIVE=true も使用できます）。（Projects アドオンが必要です。Projects API はパブリックベータ版です。）
pipedrive_search_projects	Pipedrive でタイトルからプロジェクトを検索します。（Projects アドオンが必要です。Projects API はパブリックベータ版です。）
pipedrive_archive_project	ステータスを archived に設定して、プロジェクトをアーカイブします。（Projects アドオンが必要です。Projects API はパブリックベータ版です。）
pipedrive_list_project_tasks	すでに ID を持っているプロジェクトのタスクを一覧表示します。id（プロジェクト ID）のみを渡してください。より広範なタスク検索には pipedrive_list_tasks を使用してください。（Projects アドオン。Projects API はパブリックベータ版です。）
pipedrive_list_project_templates	Pipedrive で利用できるすべてのプロジェクトテンプレートを一覧表示します。ページ分割された結果を返します。
pipedrive_get_project_template	ID を指定して、特定のプロジェクトテンプレートの詳細情報を取得します。
pipedrive_list_archived_projects	Pipedrive のアーカイブ済みプロジェクトを一覧表示します。フィルター、フェーズ、またはステータスで絞り込むこともできます。（Projects アドオン。Projects API はパブリックベータ版です。）
pipedrive_get_project_permitted_users	プロジェクトへのアクセス権を持つユーザー ID の一覧を取得します。整数のユーザー ID の配列を返します。（Projects アドオン。Projects API はパブリックベータ版です。）
pipedrive_get_project_changelog	プロジェクトの変更履歴を取得し、何が、いつ、誰によって変更されたかを表示します。actor_user_id、new_values、old_values を含む、ページ分割されたエントリを返します。（Projects アドオン。Projects API はパブリックベータ版です。）

製品

ツール	説明
pipedrive_list_products	Pipedrive の製品を一覧表示します。所有者、ID、またはフィルターによる絞り込みを指定できます。
pipedrive_get_product	ID を指定して、特定の製品の詳細情報を取得します。
pipedrive_search_products	名前、コード、またはカスタムフィールドで製品を検索します。
pipedrive_create_product	Pipedrive に新しい製品を作成します。名前のみ必須です。
pipedrive_update_product	Pipedrive の既存の製品を更新します。
pipedrive_delete_product 🔒	製品を削除します。製品は削除済みとしてマークされ、30 日後に完全に削除されます。
pipedrive_list_product_variations	製品のすべてのバリエーションを一覧表示します。
pipedrive_add_product_variation	製品にバリエーションを追加します。
pipedrive_update_product_variation	既存の製品バリエーションを更新します。
pipedrive_delete_product_variation 🔒	製品バリエーションを削除します。
pipedrive_list_product_followers	製品のすべてのフォロワーを一覧表示します。
pipedrive_add_product_follower	製品にフォロワーを追加します。
pipedrive_delete_product_follower 🔒	製品のフォロワーを削除します。
pipedrive_get_product_followers_changelog	製品のフォロワー変更履歴を取得します。
pipedrive_get_product_image	製品の画像を取得します（有効期間が 7 日間の公開 URL を持つ画像を 1 枚返します）。
pipedrive_delete_product_image 🔒	製品の画像を削除します。
pipedrive_upload_product_image	製品の画像をアップロードします。画像は file_path または base64_data のいずれかで指定します（どちらか一方が必須です）。png、jpeg、gif、webp に対応しています。注：file_path は SERVER プロセスによってファイルシステムから読み込まれ、デフォルトでは無効です。オペレーターは PIPEDRIVE_IMAGE_BASE_DIR を設定する必要があり、パスはそのディレクトリ内を指している必要があります。そうでない場合は、転送時に安全な base64_data を使用してください。
pipedrive_update_product_image	製品の画像を更新（置き換え）します。画像は file_path または base64_data のいずれかで指定します（どちらか一方が必須です）。png、jpeg、gif、webp に対応しています。注：file_path は SERVER プロセスによってファイルシステムから読み込まれ、デフォルトでは無効です。オペレーターは PIPEDRIVE_IMAGE_BASE_DIR を設定する必要があり、パスはそのディレクトリ内を指している必要があります。そうでない場合は、転送時に安全な base64_data を使用してください。

タスク

ツール	説明
pipedrive_list_tasks	すべてのプロジェクトを対象とした一般的なタスク検索です。project_id、assignee_id、完了状態／マイルストーン、親タスクによる絞り込みを指定できます。単一プロジェクトの全タスク一覧以外の用途に使用します。（Projects アドオン。Projects API はパブリックベータです。）
pipedrive_get_task	ID を指定して、特定のタスクの詳細情報を取得します。（Projects アドオン。Projects API はパブリックベータです。）
pipedrive_create_task	プロジェクトに新しいタスクを作成します。title と project_id は必須です。ブール値の is_done／is_milestone を使用します（GET レスポンスと同じフィールド名です）。マイルストーンタスクには due_date が必要です。（Projects アドオン。Projects API はパブリックベータです。）
pipedrive_update_task	既存のタスクを更新します。必須なのは id のみで、その他のフィールドはすべて任意です。ブール値の is_done／is_milestone を使用します（GET レスポンスと同じフィールド名です）。マイルストーンタスクには due_date が必要です。（Projects アドオン。Projects API はパブリックベータです。）
pipedrive_delete_task 🔒	タスクを削除します。サブタスクがある場合、それらも削除されます。PIPEDRIVE_MODE=full が必要です（後方互換性のため、PIPEDRIVE_ENABLE_DESTRUCTIVE=true も使用できます）。（Projects アドオン。Projects API はパブリックベータです。）

ボードとフェーズ

ツール	説明
pipedrive_list_boards	すべてのプロジェクトボードを一覧表示します。完全な一覧を返します（ページネーションなし — boards エンドポイントはすべてのレコードを一度に返します）。（Projects アドオン。Projects API はパブリックベータ版です。）
pipedrive_get_board	ID を指定して、特定のプロジェクトボードの詳細情報を取得します。（Projects アドオン。Projects API はパブリックベータ版です。）
pipedrive_create_board	新しいプロジェクトボードを作成します。name は必須です。（Projects アドオン。Projects API はパブリックベータ版です。）
pipedrive_update_board	既存のプロジェクトボードを更新します。必須なのは id のみで、その他のフィールドはすべて任意です。（Projects アドオン。Projects API はパブリックベータ版です。）
pipedrive_delete_board 🔒	プロジェクトボードを削除します。PIPEDRIVE_MODE=full が必要です（後方互換性のため、PIPEDRIVE_ENABLE_DESTRUCTIVE=true も使用できます）。（Projects アドオン。Projects API はパブリックベータ版です。）
pipedrive_list_phases	プロジェクトボードのすべてのフェーズを一覧表示します。board_id は必須です。完全な一覧を返します（ページネーションなし — phases エンドポイントは、そのボードのすべてのレコードを一度に返します）。（Projects アドオン。Projects API はパブリックベータ版です。）
pipedrive_get_phase	ID を指定して、特定のプロジェクトフェーズの詳細情報を取得します。（Projects アドオン。Projects API はパブリックベータ版です。）
pipedrive_create_phase	新しいプロジェクトフェーズを作成します。name と board_id は必須です。（Projects アドオン。Projects API はパブリックベータ版です。）
pipedrive_update_phase	既存のプロジェクトフェーズを更新します。必須なのは id のみで、その他のフィールドはすべて任意です。board_id を設定すると、このフェーズを別のボードに移動できます。（Projects アドオン。Projects API はパブリックベータ版です。）
pipedrive_delete_phase 🔒	プロジェクトフェーズを削除します。PIPEDRIVE_MODE=full が必要です（後方互換性のため、PIPEDRIVE_ENABLE_DESTRUCTIVE=true も使用できます）。（Projects アドオン。Projects API はパブリックベータ版です。）

メール

ツール	説明
pipedrive_get_person_emails	人物に紐付けられたメールメッセージを取得します（会社全体、全ユーザーのメール）。この人物に紐付けられた、任意のユーザーのメールボックス内のメールのメタデータを返します。注：メッセージ本文全体を取得するには pipedrive_get_mail_message を使用します。ただし、取得できるのはご自身のメールボックス内のメールのみです。
pipedrive_get_deal_emails	取引に紐付けられたメールメッセージを取得します（会社全体、全ユーザーのメール）。この取引に紐付けられた、任意のユーザーのメールボックス内のメールのメタデータを返します。注：メッセージ本文全体を取得するには pipedrive_get_mail_message を使用します。ただし、取得できるのはご自身のメールボックス内のメールのみです。
pipedrive_list_mail_threads	ご自身のメールボックス（認証済みユーザー）のメールスレッドのみを一覧表示します。他のユーザーのスレッドにはアクセスできません。folder パラメーターを使用して、受信トレイ、下書き、送信済み、アーカイブで絞り込めます。
pipedrive_get_mail_thread	メッセージを含むメールスレッドを取得します。アクセス可否は可視性設定によって異なります。アクセス可能な取引や人物内で表示されるスレッドであれば、取得できるはずです。スレッドにアクセスできない場合は 404 を返します。
pipedrive_get_mail_message	本文を含むメールメッセージ全体を取得します。アクセス可否は可視性設定によって異なります。アクセス可能な取引や人物に紐付けられたメッセージであれば、他のユーザーが送信したものでも取得できるはずです。

フィールド

ツール	説明
pipedrive_list_organization_fields	カスタムフィールドを含む、すべての組織フィールド定義を一覧表示します。40 文字のフィールドキーを人が読める名前に対応付ける際に使用します。
pipedrive_list_deal_fields	カスタムフィールドを含む、すべての案件フィールド定義を一覧表示します。案件データの構造を理解するうえで不可欠です。
pipedrive_list_person_fields	カスタムフィールドを含む、すべての人物フィールド定義を一覧表示します。連絡先データの構造を理解する際に使用します。
pipedrive_list_product_fields	カスタムフィールドを含む、すべての商品フィールド定義を一覧表示します。
pipedrive_list_project_fields	カスタムフィールドを含む、すべてのプロジェクトフィールド定義を一覧表示します。（Projects アドオン。Projects API はパブリックベータ版です。）
pipedrive_get_field	キーを指定して、特定のフィールドの詳細を取得します。40 文字のハッシュ形式のフィールドキーが何を意味するかを調べるのに便利です。
pipedrive_create_deal_field	案件のカスタムフィールドを作成します。field_name と field_type は必須です。enum/set 型の場合、options も必須です。レスポンスの data.field_code は 40 文字のハッシュで、後からフィールドを更新または削除する際に保持しておく必要があります。
pipedrive_update_deal_field	field_code を指定して、案件のカスタムフィールドを更新します。field_type と field_code は変更できません。
pipedrive_delete_deal_field 🔒	field_code を指定して、案件のカスタムフィールドを削除します。PIPEDRIVE_MODE=full が必要です（後方互換性のため、PIPEDRIVE_ENABLE_DESTRUCTIVE=true も使用できます）。
pipedrive_update_deal_field_options	案件の enum/set フィールドのオプションラベルを一括更新します。アトミックに実行されるため、いずれかのオプション ID が存在しない場合、リクエスト全体が失敗します。
pipedrive_delete_deal_field_options 🔒	案件の enum/set フィールドのオプションを一括削除します。いずれかの ID が存在しない場合、アトミックに失敗します。PIPEDRIVE_MODE=full が必要です（後方互換性のため、PIPEDRIVE_ENABLE_DESTRUCTIVE=true も使用できます）。
pipedrive_create_person_field	人物のカスタムフィールドを作成します。field_name と field_type は必須です。enum/set 型の場合、options も必須です。レスポンスの data.field_code は、後から更新する際に保持しておく 40 文字のハッシュです。
pipedrive_update_person_field	field_code を指定して、人物のカスタムフィールドを更新します。field_type と field_code は変更できません。
pipedrive_delete_person_field 🔒	人物のカスタムフィールドを field_code で削除します。PIPEDRIVE_MODE=full が必要です（後方互換性のため、PIPEDRIVE_ENABLE_DESTRUCTIVE=true も使用できます）。
pipedrive_update_person_field_options	人物の enum/set フィールドのオプションラベルを一括更新します。アトミックに実行されるため、いずれかのオプション ID が存在しない場合、リクエスト全体が失敗します。
pipedrive_delete_person_field_options 🔒	人物の enum/set フィールドのオプションを一括削除します。いずれかの ID が存在しない場合、アトミックに失敗します。PIPEDRIVE_MODE=full が必要です（後方互換性のため、PIPEDRIVE_ENABLE_DESTRUCTIVE=true も使用できます）。
pipedrive_create_organization_field	組織のカスタムフィールドを作成します。field_name と field_type は必須です。enum/set 型の場合、options も必須です。レスポンスの data.field_code は、後から更新する際に保持しておく 40 文字のハッシュです。
pipedrive_update_organization_field	field_code を指定して、組織のカスタムフィールドを更新します。field_type と field_code は変更できません。
pipedrive_delete_organization_field 🔒	field_code を指定して、組織のカスタムフィールドを削除します。PIPEDRIVE_MODE=full が必要です（後方互換性のため、PIPEDRIVE_ENABLE_DESTRUCTIVE=true も使用できます）。
pipedrive_update_organization_field_options	組織の enum/set フィールドのオプションラベルを一括更新します。アトミックに実行されるため、いずれかのオプション ID が存在しない場合、リクエスト全体が失敗します。
pipedrive_delete_organization_field_options 🔒	組織の enum/set フィールドのオプションを一括削除します。いずれかの ID が存在しない場合、アトミックに失敗します。PIPEDRIVE_MODE=full が必要です（後方互換性のため、PIPEDRIVE_ENABLE_DESTRUCTIVE=true も使用できます）。
pipedrive_create_product_field	商品のカスタムフィールドを作成します。field_name と field_type は必須です。enum/set 型の場合、options も必須です。商品フィールドでは、よりシンプルなモデルが使用されます。description、important_fields、required_fields はありません。レスポンスの data.field_code は、後から更新する際に保持しておく 40 文字のハッシュです。
pipedrive_update_product_field	field_code を指定して、商品のカスタムフィールドを更新します。変更できるのは field_name と ui_visibility のみです（商品フィールドには description、important_fields、required_fields がありません）。
pipedrive_delete_product_field 🔒	field_code を指定して、商品のカスタムフィールドを削除します。PIPEDRIVE_MODE=full が必要です（後方互換性のため、PIPEDRIVE_ENABLE_DESTRUCTIVE=true も使用できます）。
pipedrive_update_product_field_options	商品の enum/set フィールドのオプションラベルを一括更新します。アトミックに実行されるため、いずれかのオプション ID が存在しない場合、リクエスト全体が失敗します。
pipedrive_delete_product_field_options 🔒	商品の enum/set フィールドのオプションを一括削除します。いずれかの ID が存在しない場合、アトミックに失敗します。PIPEDRIVE_MODE=full が必要です（後方互換性のため、PIPEDRIVE_ENABLE_DESTRUCTIVE=true も使用できます）。

パイプラインとステージ

ツール	説明
pipedrive_list_pipelines	カーソルページネーションを使用して、Pipedrive の営業パイプラインを一覧表示します。パイプラインには、取引が進んでいくステージが含まれます。
pipedrive_list_stages	カーソルページネーションを使用してステージを一覧表示します。必要に応じてパイプラインで絞り込めます。ステージは営業プロセスの各段階を表します。
pipedrive_get_stage	ID を指定して、特定のステージの詳細を取得します。
pipedrive_create_pipeline	新しい営業パイプラインを作成します。必須項目は名前のみです。is_deal_probability_enabled を設定すると、パイプラインの加重取引確度を有効にできます。
pipedrive_update_pipeline	既存のパイプラインを更新します。パイプライン ID と変更するフィールドを指定します。
pipedrive_delete_pipeline 🔒	パイプラインを削除します。パイプラインを削除済みとしてマークします。PIPEDRIVE_MODE=full が必要です（後方互換性のため、PIPEDRIVE_ENABLE_DESTRUCTIVE=true も使用できます）。
pipedrive_create_stage	パイプラインに新しいステージを作成します。name と pipeline_id が必須です。is_deal_rot_enabled と days_to_rotten を使用して、取引の失効設定を行います。
pipedrive_update_stage	既存のステージを更新します。ステージ ID と変更するフィールドを指定します。pipeline_id を設定すると、ステージを別のパイプラインに移動できます。
pipedrive_delete_stage 🔒	ステージを削除します。ステージを削除済みとしてマークします。PIPEDRIVE_MODE=full が必要です（後方互換性のため、PIPEDRIVE_ENABLE_DESTRUCTIVE=true も使用できます）。

ユーザー

ツール	説明
pipedrive_list_users	Pipedrive アカウントのすべてのユーザーを一覧表示します。レコードの作成や絞り込みに使う所有者 ID を探すのに便利です。
pipedrive_get_user	ID を指定して、特定のユーザーの詳細を取得します。
pipedrive_get_current_user	このサーバーが接続している Pipedrive アカウントを確認します。接続先の会社（名前、ID、ドメイン）と API キー所有者のユーザー詳細を返します。データの取得元の会社を確認したり、自分のユーザー ID を取得したりする際に使用します。

ワークフローの例

取引パイプラインの分析

"Show me all open deals in the Sales pipeline, sorted by value"
"Get details for deal 12345 including custom fields"
"Move deal 12345 to the Proposal stage"

顧客調査

"Find contacts at Acme Corp"
"Get emails for person 456 to analyze their engagement"
"What custom fields do we have for persons?"

アクティビティ管理

"List my overdue activities"
"Create a follow-up call with John Smith for tomorrow at 2pm"
"Mark activity 789 as done"

フィールドの確認

"List all custom fields for deals"
"What does field '8a4d7f...' mean?" (40-char hash)

開発

ローカル環境のセットアップ

git clone https://github.com/ckalima/pipedrive-mcp-server.git
cd pipedrive-mcp-server
npm install
cp .env.example .env
# Edit .env with your API key

ビルドと実行

npm run build
npm run start

開発モード

npm run dev

MCP Inspector でのテスト

npx @modelcontextprotocol/inspector node dist/index.js

API のバージョン管理

このサーバーは Pipedrive API の両方のバージョンを使用し、各呼び出しを適切なバージョンに自動的に振り分けます。

• v2（/api/v2）：取引、人物、組織、アクティビティ、製品、プロジェクト、タスク、ボードとフェーズ、フィールド、パイプラインとステージ、リード検索
• v1（/v1）：メール、ノート、ユーザー、リードの CRUD

Pipedrive は v1 を段階的に終了します。v2 に相当する機能がある一部の v1 エンドポイントは 2025-12-31 にサポート終了となり、v1 全体の終了は 2026-07-31 頃を予定しています。上記の v1 機能（メール、ノート、ユーザー、リードの CRUD）には、まだ v2 の代替機能がありません。詳細は docs/v1-only-capabilities.md を参照してください。

エラー処理

エラーには、問題を解決するための提案が含まれます。

{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "API key is invalid or expired",
    "suggestion": "Verify your API key at Pipedrive Settings > Personal preferences > API"
  }
}

一般的なエラーコード：

• MISSING_API_KEY - PIPEDRIVE_API_KEY 環境変数を設定してください
• INVALID_API_KEY - Pipedrive の設定で API キーを確認してください
• NOT_FOUND - リクエストされたリソースは存在しません
• RATE_LIMITED - 60 秒待ってから再試行してください
• VALIDATION_ERROR - リクエストパラメーターを確認してください

セキュリティ

脅威モデル（データフロー、認証情報の取り扱い、プロンプトインジェクションに対する誠実性、AI／エージェントの攻撃対象領域の一覧、運用者向けのベストプラクティス、既知の制限事項）と、脆弱性を非公開で報告する方法については、SECURITY.md をご覧ください。要点は、STDIO のみを使用し、ネットワークリスナーはなく、API トークンは環境変数から読み込まれてログに記録されず、破壊的な操作はデフォルトで無効になっており、CRM ツールの出力には構造的に信頼できないデータであることを示すラベルが付けられる（これは助言的な緩和策であり、保証ではありません。残存リスクに関する注記をご覧ください）ということです。

最小権限でデプロイするには、専用の制限付き Pipedrive ユーザーからトークンを発行し、必要でない限り破壊的な操作を無効にしておき、CRM データ内のプロンプトインジェクションに外部への情報流出経路がないよう、エージェントのコンテキストを分離してください。運用者向けのベストプラクティスをご覧ください。

貢献

ガイドラインについては、CONTRIBUTING.md をご覧ください。

ライセンス

MIT - LICENSE をご覧ください。

リンク

• Pipedrive API ドキュメント
• MCP プロトコル
• セキュリティポリシー
• 問題を報告