Pipedrive CRM API と連携するためのモデル制御プロトコル(MCP)サーバーの実装。 このサーバーでは、Claude が MCP ツールコールを介して Pipedrive レコードを作成、読み込み、更新、削除することができます。

##特徴

この MCP サーバーでは、次の Pipedrive 機能を実行します。

• Persons - 作成、読み取り、更新、削除、および検索の人体 -組織 - 組織とそのフォロワーを管理する
• 取引 - 取引商品を含む取引の作成、管理、および検索取引
• リード - 鉛ラベルを含むリードの作成、管理、および検索リード
• アクティビティ - アクティビティとアクティビティの種類を追跡し、管理する
• 項目検索 - パイプラインドライブのエンティティティを横断するグローバルおよびフィールド固有の検索

追加機能:

• 包括的なエラー処理で API クライアントを Async
• 特定のモジュールを有効に/無効にする機能フラグ
• メンテナンス性のための垂直スライスアーキテクチャ
• 包括的なテストカバレッジ

クイックスタートClaudeコード

Pipedrive MCP Server を始め、デスクトップアプリで設定する最速の方法です。

##1. 必要なツールをインストール

端末またはコマンドプロンプトを開き、次のコマンドを実行します

Pipedrive MCP Server

A Model Control Protocol (MCP) server implementation for interacting with the Pipedrive CRM API. This server enables Claude to create, read, update, and delete Pipedrive records through MCP tool calls.

Features

This MCP server implements the following Pipedrive features:

• Persons - Create, read, update, delete, and search person entities
• Organizations - Manage organizations and their followers
• Deals - Create, manage, and search deals, including deal products
• Leads - Create, manage, and search leads including lead labels
• Activities - Track and manage activities and activity types
• Item Search - Global and field-specific search across Pipedrive entities

Additional features:

• Async API client with comprehensive error handling
• Feature flags to enable/disable specific modules
• Vertical slice architecture for maintainability
• Comprehensive test coverage

Quick Start with Claude Code

The fastest way to get started with the Pipedrive MCP Server and set it up in your claude desktop app:

1. Install Required Tools

Open your terminal or command prompt and run these commands:

# Install Python's uv package manager (if not already installed)
curl -sSf https://install.python-uv.org/uv | python3 -

For more detailed installation instructions for uv, visit: Astral’s UV Installation Documentation

2. Download the Code

No GitHub account required! Just run these commands in your terminal:

Select a folder where you want the code to be downloaded to and run these commands:

# Clone the repository (download the code)
git clone https://github.com/Wirasm/pipedrive-mcp.git

# Move into the project folder
cd pipedrive-mcp

3. Install Python Dependencies

Open your terminal and run this command exactly as written:

# Install all required packages
uv sync

4. Set Up Your Pipedrive Credentials

1. Find the .env.example file in the project folder
2. Make a copy and rename it to just .env
3. Open the .env file in any text editor
4. Replace the placeholders with your actual Pipedrive information:

PIPEDRIVE_API_TOKEN=your_api_token
PIPEDRIVE_COMPANY_DOMAIN=your_company_domain

All other configurations you see in the .env file are optional and can be left as is.

To get your Pipedrive API Token:

1. Log in to your Pipedrive account
2. Click on your profile picture in the top-right corner
3. Select “Personal preferences”
4. Go to the “API” tab
5. Click “Generate new token” if you don’t already have one
6. Copy the generated token and paste it in the .env file

For the company domain: If your Pipedrive URL is https://mycompany.pipedrive.com/pipeline, then your domain is mycompany

5. Install the MCP Server in Claude Desktop

Open your terminal and run this command:

# Install the MCP server
mcp install server.py