pipedriver

MCP server for the Pipedrive API v2. Expose Pipedrive (deals, persons, organizations, products, activities, pipelines, and more) as tools to any Model Context Protocol client—Cursor, Claude Desktop, and others.

Built with the official Pipedrive JavaScript SDK and the MCP TypeScript SDK.

---

Quick start (npx)

No install. Run the server with your Pipedrive API token:

PIPEDRIVE_API_KEY=your_api_token npx pipedriver

Then point your MCP client at this command. Example for Cursor (Settings → MCP → Edit config):

{
  "mcpServers": {
    "pipedriver": {
      "command": "npx",
      "args": ["-y", "pipedriver"],
      "env": {
        "PIPEDRIVE_API_KEY": "your_api_token"
      }
    }
  }
}

Get an API token in Pipedrive → Settings → API.

---

Usage

How it runs

The server uses stdio transport: your MCP client starts it as a subprocess and talks over stdin/stdout. No HTTP server or port.

Option A: npx (recommended for trying it out)

npx -y pipedriver

Set PIPEDRIVE_API_KEY in the environment (or in your MCP config env, as in the example above).

Option B: Install and run

npm install -g pipedriver
# or: yarn global add pipedriver

export PIPEDRIVE_API_KEY=your_api_token
pipedriver

Option C: From a local clone (development)

git clone https://github.com/vaibhavpandeyvpz/pipedriver.git
cd pipedriver
yarn install
export PIPEDRIVE_API_KEY=your_api_token
yarn dev

In your MCP config, use the path to the repo:

{
  "mcpServers": {
    "pipedriver": {
      "command": "node",
      "args": ["/path/to/pipedriver/dist/index.js"],
      "env": { "PIPEDRIVE_API_KEY": "your_api_token" }
    }
  }
}

Or without building (runs TypeScript with tsx):

{
  "mcpServers": {
    "pipedriver": {
      "command": "npx",
      "args": ["tsx", "/path/to/pipedriver/src/index.ts"],
      "env": { "PIPEDRIVE_API_KEY": "your_api_token" }
    }
  }
}

Tool naming

Tools follow pipedrive_<domain>_<action>, e.g. pipedrive_deals_list, pipedrive_persons_add. Arguments and request bodies match the Pipedrive API v2 (filters, sort, pagination, and JSON bodies where applicable).

---

Tools overview

Domain	Examples
Activities	add, delete, list, get, update
Activity fields	get, list (metadata)
Deals	add, delete, list, get, update, search; products (add/delete/update/many); followers; convert to lead; additional discounts; installments
Deal fields	get, list (metadata)
Item search	search, search by field
Leads	search, convert to deal, get conversion status
Organizations	add, delete, list, get, update, search; followers
Organization fields	get, list (metadata)
Persons	add, delete, list, get, update, search; picture; followers
Person fields	get, list (metadata)
Pipelines	add, delete, list, get, update
Products	add, delete, list, get, update, search; followers; duplicate; variations; image
Product fields	get, list (metadata)
Stages	add, delete, list, get, update
Users	get followers

Each tool’s input schema in your MCP client describes parameters and optional fields.

---

Development

Prerequisites

• Node.js 18+
• Yarn (or npm)

Setup

git clone https://github.com/vaibhavpandeyvpz/pipedriver.git
cd pipedriver
yarn install

Create a .env or export your token:

export PIPEDRIVE_API_KEY=your_api_token

Commands

Command	Description
yarn dev	Run server from source (no build) via tsx
yarn build	Compile TypeScript to dist/
yarn start	Run compiled server (node dist/index.js)
yarn test	Run Jest tests (start server, connect, list tools)

Project layout

• src/ – Server entry, MCP server setup, Pipedrive client wrapper
• src/tools/ – Tool handlers per domain (deals, persons, products, etc.)
• src/schemas/ – Zod schemas for request bodies
• tests/ – Integration tests (Jest)

---

Deployment

This server is not a long-lived HTTP service. It is started by your MCP client when needed and communicates over stdio.

• Production use = your MCP client (e.g. Cursor, Claude Desktop) runs npx pipedriver or pipedriver with PIPEDRIVE_API_KEY set. No extra deployment step.
• Publishing: The package is published to npm via GitHub Actions on version tags (v*). See .github/workflows/publish-npm.yml.

---

License

MIT © Vaibhav Pandey