Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@pipedrive-mcp list all deals in the negotiation stage"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Full-featured Pipedrive MCP server for Claude Desktop. Supports deals, leads, persons, organizations, notes, activities, pipelines, and more — all controllable via natural language.
Add the following to your claude_desktop_config.json:
{
"mcpServers": {
"pipedrive": {
"command": "npx",
"args": ["-y", "pipedrive-mcp"],
"env": {
"PIPEDRIVE_API_TOKEN": "your_api_token_here",
"PIPEDRIVE_COMPANY_DOMAIN": "your_company_subdomain"
}
}
}
}Where to find your credentials:
PIPEDRIVE_API_TOKEN: Pipedrive → Settings → Personal preferences → API → Your personal API token
PIPEDRIVE_COMPANY_DOMAIN: Just the subdomain of your Pipedrive URL. If your URL is https://mycompany.pipedrive.com, use mycompany
Config file location:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
After saving, restart Claude Desktop.
Related MCP server: Pipedrive MCP Server
Tool | Description |
| List deals with advanced filters — status, stage, pipeline, owner, value range, days back, title search |
| Get full deal details including resolved custom fields |
| Create a new deal |
| Update deal fields (title, value, stage, status, owner, etc.) |
| Permanently delete a deal |
| Search deals by keyword |
Tool | Description |
| List leads with optional filters (owner, person, org, archived status) |
| Get full lead details by UUID |
| Create a new lead with value, labels, and linked contacts |
| Update lead fields or archive/unarchive |
| Permanently delete a lead |
| Search leads by keyword |
| List all available lead labels (for use with label_ids) |
| List all available lead sources |
Tool | Description |
| List contacts with pagination |
| Get full contact details including resolved custom fields |
| Create a new contact with email, phone, and org |
| Update contact fields |
| Permanently delete a contact |
| Search contacts by name, email, or phone |
Tool | Description |
| List organizations with pagination |
| Get full org details including resolved custom fields |
| Create a new organization |
| Permanently delete an organization |
| Search organizations by name or address |
Tool | Description |
| List notes filtered by deal, person, or organization |
| Add a note to a deal, contact, or organization |
Tool | Description |
| List activities filtered by deal, person, org, or completion status |
| Create a new activity (call, meeting, email, task, etc.) |
| Update or mark an activity as done |
Tool | Description |
| List all sales pipelines |
| List stages, optionally filtered by pipeline |
Tool | Description |
| List all users with ID, name, email, and active status |
Tool | Description |
| Global search across all item types simultaneously |
Total: 34 tools
Pre-built conversation starters available in Claude Desktop:
Prompt | Description |
| Complete overview of all deals organized by status with total pipeline value |
| Full contact list grouped by organization |
| Deep pipeline analysis: values, stages, win rates, overdue deals, top deals by owner |
| Contact and org overview with deal activity, engagement stats, cold prospects |
| Prioritized list of highest-value open deals with activity flags |
| Leads analysis: volume, owners, labels, values, upcoming close dates |
| Side-by-side comparison of all pipelines with conversion rates |
Rate limiting — Bottleneck-based rate limiting stays safely under Pipedrive's API limits (70 req/2s)
Custom fields — get_deal, get_person, get_organization automatically resolve custom field hash keys to human-readable names and option labels
Full leads CRUD — Complete lead lifecycle: create, read, update, delete, search, label, archive
Advanced deal filtering — Filter by pipeline, value range, age, title keyword on top of standard filters
Delete operations — Permanently delete deals, leads, persons, and organizations
Global search — Search across all CRM record types in one call
Structured responses — All tools return both markdown text and structured JSON data
Node.js 18 or higher
A Pipedrive account with API access
Claude Desktop
git clone <repo>
cd pipedrive-mcp-server
npm install
npm run build
# Run locally
PIPEDRIVE_API_TOKEN=xxx PIPEDRIVE_COMPANY_DOMAIN=mycompany node dist/index.jsFor local use, update claude_desktop_config.json to point to the built file:
{
"mcpServers": {
"pipedrive": {
"command": "node",
"args": ["/absolute/path/to/pipedrive-mcp-server/dist/index.js"],
"env": {
"PIPEDRIVE_API_TOKEN": "your_token",
"PIPEDRIVE_COMPANY_DOMAIN": "your_subdomain"
}
}
}
}npm login
npm publishAfter publishing, anyone can use it via the npx config shown at the top — no local installation needed.
This server cannot be deployed
API-first CRM for LLMs - contacts, companies, deals and activities over a native MCP server.
Marketo MCP server for AI. 130 tools to operate Marketo from Claude, Cursor, or ChatGPT.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
