Pipedrive MCP Server Released

If you’ve ever spent ten minutes clicking through Pipedrive filters trying to answer “What deals did we add last week worth over $10k?”, you know exactly why we built this.

Pipedrive has solid APIs. The problem is nobody wants to write API calls to check their pipeline. You want to ask a question and get an answer.

That’s what this does.

What’s MCP?

Model Context Protocol is Anthropic’s open standard for connecting AI assistants to external data. Think of it as a USB port for LLMs. You plug in a server, and suddenly Claude can query your Pipedrive instance directly.

No middleware. No custom integrations. Just a persistent connection between your AI assistant and your CRM data.

What you can do with it

The server exposes 22 tools across your Pipedrive data:

Deals

• Search and filter deals by title, owner, stage, pipeline, status, date range, or value
• Pull full deal details including custom fields
• Read deal notes and activity history

Contacts and organisations

• Search people by name, email, or phone
• Search companies by name or address
• Get full records with all your custom fields intact

Pipeline visibility

• List all pipelines and stages
• See where deals sit in your process

Activities

• Pull calls, meetings, tasks, and emails
• Filter by person, deal, org, user, or date range
• Check activity types you’ve configured

Leads

• Search leads before they become deals

Cross-type search

• Query across deals, people, orgs, and leads simultaneously

Field definitions

• Map those cryptic custom field hashes (abc123_custom_field) to actual readable names

Real examples

Monday pipeline review:

“Show me all deals updated this week in the Enterprise pipeline”

Before a client call:

“What’s the history with Acme Corp? Show me their deals, contacts, and recent activities”

Checking coverage:

“List deals over $50k with no activity in the last 30 days”

Finding contacts:

“Search for anyone at companies in the technology sector”

The AI handles the API calls. You get answers in plain English.

Technical bits

The server runs on Python 3.10+ using FastMCP. It’s async, handles rate limiting automatically (Pipedrive’s API has limits), and paginates through large result sets without you thinking about it.

Authentication uses your Pipedrive API token. The server needs read access only. It doesn’t write, update, or delete anything.

Dependencies are minimal: mcp, httpx, and python-dotenv. That’s it.

Setup

1. Clone and install

git clone  https://github.com/osherai/pipedrive-mcp-python.git
cd pipedrive-mcp-python
uv sync  # or pip install -e .

2. Configure credentials

Create a .env file:

PIPEDRIVE_API_TOKEN=your_api_token_here
PIPEDRIVE_DOMAIN=yourcompany.pipedrive.com

Get your API token from Pipedrive Settings > Personal preferences > API.

3. Add to Claude

For Claude Desktop, add to your config file:

{
  "mcpServers": {
    "pipedrive": {
      "command": "/path/to/venv/bin/python",
      "args": ["-m", "pipedrive_mcp.server"],
      "cwd": "/path/to/pipedrive-mcp-python"
    }
  }
}

For Claude Code CLI:

claude mcp add pipedrive -- /path/to/venv/bin/python -m pipedrive_mcp.server

Restart Claude. Ask it something about your Pipedrive data. If it answers, you’re done.

Why free?

Same reason as our Bullhorn server. MCP is new. The ecosystem needs more connectors. We’d rather have a hundred teams using this and finding edge cases than charge for something and support three users.

It’s MIT licensed. Fork it, modify it, use it commercially. We don’t care.

What it isn’t

It’s read-only. You can’t create deals, update contacts, or log activities through this server. That’s intentional. We wanted something safe to deploy without worrying about AI assistants accidentally modifying your CRM data.

It’s not a reporting engine. Complex aggregations, pivot tables, revenue forecasting – that’s still your BI tool’s job. This is for quick lookups and searches.

It doesn’t handle every edge case. Pipedrive has hundreds of API endpoints. We built the ones that matter for day-to-day sales work. If you need something specific, open an issue or submit a PR.

It won’t replace your Pipedrive subscription. You still need a Pipedrive account with API access. This just gives you a better way to query it.

About Osher Digital

Osher Digital helps businesses put AI to practical use. Automation workflows, custom integrations, solutions that actually work without enterprise complexity.

Want to talk about custom AI for your business? Get in touch