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