Pipedrive MCP Server
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 Server show me my open deals"
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.
Pipedrive MCP Server
A Model Context Protocol (MCP) server for Pipedrive CRM. This server allows LLMs like Claude to interact with your Pipedrive data through a standardized interface.
Developed by Osher Digital
Features
22 Tools for comprehensive Pipedrive access
Saved Filter Support: Use Pipedrive's saved filters to query by custom fields
Field Definitions: Map custom field hashes to human-readable names
Activities: Access calls, meetings, tasks, and emails
Flexible Sorting: Sort deals by date, value, or title
Date Range Filtering: Filter by created/updated dates
Rate Limiting: Built-in rate limiting to respect Pipedrive API limits
Related MCP server: Pipedrive MCP Server
Installation
cd pipedrive-mcp-python
# Install with uv
uv syncConfiguration
Create a .env file in the project root (or set environment variables):
# Required
PIPEDRIVE_API_TOKEN=your_api_token_here
PIPEDRIVE_DOMAIN=your-company.pipedrive.com
# Optional - Rate Limiting
PIPEDRIVE_RATE_LIMIT_MIN_TIME_MS=250
PIPEDRIVE_RATE_LIMIT_MAX_CONCURRENT=2Getting Your API Token
Log into your Pipedrive account
Go to Settings > Personal preferences > API
Copy your API token
Usage
Running the Server
# Run with uv
uv run pipedrive-mcpClaude Desktop Integration
Add to your Claude Desktop configuration:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonLinux:
~/.config/claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"pipedrive": {
"command": "/path/to/pipedrive-mcp-python/.venv/bin/python",
"args": ["-m", "pipedrive_mcp.server"],
"cwd": "/path/to/pipedrive-mcp-python"
}
}
}Set environment variables in your shell profile or .env file in the project directory.
Claude Code CLI Integration
claude mcp add pipedrive -- /path/to/pipedrive-mcp-python/.venv/bin/python -m pipedrive_mcp.serverAvailable Tools (22)
User Management
Tool | Description |
| Get all users/owners from Pipedrive |
Deals
Tool | Description |
| Get deals with comprehensive filtering (see below) |
| Get a single deal by ID with all custom fields |
| Get notes for a specific deal |
| Full-text search deals |
get_deals parameters:
search_title- Search by deal title (partial matches)owner_id- Filter by owner/user IDstage_id- Filter by pipeline stagestatus- Filter by status:open,won,lost,deleted(default:open)pipeline_id- Filter by pipelinefilter_id- Use a saved filter from Pipedrivemin_value/max_value- Filter by deal value rangecreated_after/created_before- Filter by creation date (ISO format: YYYY-MM-DD)updated_after/updated_before- Filter by update datesort_by- Sort field:add_time,update_time,title,value(default:add_time)sort_order- Sort direction:asc,desc(default:desc)limit- Maximum results (default: 500)
Persons (Contacts)
Tool | Description |
| Get all persons, optionally filtered by saved filter |
| Get a single person by ID with all custom fields |
| Full-text search persons |
Organizations
Tool | Description |
| Get all organizations, optionally filtered |
| Get a single organization by ID |
| Full-text search organizations |
Pipelines & Stages
Tool | Description |
| Get all sales pipelines |
| Get a single pipeline by ID |
| Get all stages, optionally filtered by pipeline |
Leads
Tool | Description |
| Full-text search leads |
Universal Search
Tool | Description |
| Search across all item types |
Supported item types: deal, person, organization, product, file, activity, lead
Filters
Tool | Description |
| Get all saved filters from Pipedrive |
Filter types: deals, persons, org, products, activities
Use saved filters to query by custom fields:
Create a filter in Pipedrive UI with your criteria
Call
get_filters()to find the filter's IDPass
filter_idtoget_persons(),get_deals(), orget_organizations()
Field Definitions
Tool | Description |
| Get deal field definitions (maps hash IDs to names) |
| Get person field definitions |
| Get organization field definitions |
These tools map custom field hash keys (like c3976c9693716fc786c2092081506816441ee526) to human-readable field names.
Activities
Tool | Description |
| Get activities (calls, meetings, tasks, emails) |
| Get all activity types configured in Pipedrive |
get_activities parameters:
deal_id- Filter by dealperson_id- Filter by personorg_id- Filter by organizationuser_id- Filter by assigned useractivity_type- Filter by type (call, meeting, task, email, etc.)done- Filter by completion status (True/False)start_date/end_date- Filter by date range (ISO format)limit- Maximum results (default: 100)
Examples
Get 10 most recent deals
get_deals(limit=10)Get deals created this year
get_deals(created_after="2026-01-01")Get highest value deals
get_deals(sort_by="value", sort_order="desc", limit=10)Get contacts matching a saved filter
get_filters(filter_type="persons") # Find the filter ID
get_persons(filter_id=122) # Use the filterGet all calls for a specific deal
get_activities(deal_id=123, activity_type="call")Understand a custom field
get_deal_fields() # Returns mapping of hash keys to field namesDevelopment
# Install with dev dependencies
uv sync --extra dev
# Run tests
uv run pytest
# Run with verbose output
uv run pytest -vLicense
MIT License - see LICENSE file for details.
Attribution
Developed by Osher Digital - Digital transformation and AI integration specialists.
Available Tools
22 toolsget_activitiesA
Get activities (calls, meetings, tasks, emails) from Pipedrive.
Retrieves activities with various filter options. Can filter by linked entities, type, completion status, and date range.
Args: deal_id: Filter by deal ID person_id: Filter by person ID org_id: Filter by organization ID user_id: Filter by assigned user ID activity_type: Filter by type (call, meeting, task, email, etc.) done: Filter by completion status (True=done, False=not done) start_date: Activities from this date (ISO format: YYYY-MM-DD) end_date: Activities until this date (ISO format: YYYY-MM-DD) limit: Maximum results (default: 100)
Returns: JSON array of activities with subject, type, due date, done status, notes, and linked entities
Examples: - get_activities() - Get recent activities - get_activities(deal_id=123) - Get activities for a specific deal - get_activities(done=False) - Get incomplete activities - get_activities(activity_type="call") - Get all calls - get_activities(start_date="2026-01-01", end_date="2026-01-31") - Get January activities
Inputs: deal_id, person_id, org_id, user_id, +5 more. Returns: result
get_activity_typesA
Get all activity types configured in Pipedrive.
Returns the list of activity types (call, meeting, task, lunch, etc.) available in your Pipedrive account. Use this to know what types can be used when filtering activities.
Returns: JSON array of activity types with id, name, and icon
Examples: - get_activity_types() - Get all available activity types
Inputs: no named parameters. Returns: result
get_dealA
Get a single deal by ID with all details.
Retrieves comprehensive information about a specific deal including all custom fields, owner info, pipeline stage, and related entities.
Args: deal_id: The Pipedrive deal ID
Returns: JSON object with deal details
Examples: - get_deal(deal_id=123) - Get deal with ID 123
Inputs: deal_id (required). Returns: result
get_deal_fieldsA
Get all deal field definitions from Pipedrive.
Returns field metadata that maps the hash IDs (like 'c3976c9693716fc786c2092081506816441ee526') to human-readable names. Essential for understanding custom fields in deal data.
Returns: JSON array of field definitions with: - key: The field ID/hash used in deal data - name: Human-readable field name - field_type: Type of field (text, number, date, enum, etc.) - options: Available options for enum/set fields
Examples: - get_deal_fields() - Get all deal field definitions
Inputs: no named parameters. Returns: result
get_deal_notesA
Get notes for a specific deal.
Retrieves all notes and comments associated with a deal.
Args: deal_id: The Pipedrive deal ID
Returns: JSON array of notes
Examples: - get_deal_notes(deal_id=123) - Get notes for deal 123
Inputs: deal_id (required). Returns: result
get_dealsA
Get deals from Pipedrive with filtering options.
Retrieves deals with various filter options. Can filter by title search, date ranges, owner, stage, status, pipeline, and value range. Results are sorted by creation date (newest first) by default.
Args: search_title: Search by deal title (partial matches) owner_id: Filter by owner/user ID stage_id: Filter by pipeline stage status: Filter by status - 'open', 'won', 'lost', or 'deleted' (default: 'open') pipeline_id: Filter by pipeline filter_id: ID of a saved filter from Pipedrive (use get_filters to see available filters) min_value: Minimum deal value filter max_value: Maximum deal value filter created_after: Only deals created after this date (ISO format: YYYY-MM-DD) created_before: Only deals created before this date (ISO format: YYYY-MM-DD) updated_after: Only deals updated after this date (ISO format: YYYY-MM-DD) updated_before: Only deals updated before this date (ISO format: YYYY-MM-DD) sort_by: Field to sort by - 'add_time', 'update_time', 'title', 'value' (default: 'add_time') sort_order: Sort direction - 'asc' or 'desc' (default: 'desc' for newest first) limit: Maximum number of results (default: 500)
Returns: JSON array of deals with summary
Examples: - get_deals() - Get all open deals (newest first) - get_deals(limit=10) - Get 10 most recent open deals - get_deals(status="won") - Get won deals - get_deals(created_after="2026-01-01") - Get deals created this year - get_deals(filter_id=5) - Get deals matching saved filter #5 - get_deals(sort_by="value", sort_order="desc") - Get highest value deals first
Inputs: search_title, owner_id, stage_id, status, +11 more. Returns: result
get_filtersA
Get all saved filters from Pipedrive.
Returns the list of saved filters that can be used with get_deals, get_persons, and get_organizations. Filters allow you to query by custom fields that aren't directly supported in the API.
To filter by custom fields (like "User Type = cemoh"):
Create a filter in Pipedrive UI with your criteria
Use get_filters() to find the filter's ID
Pass that filter_id to get_persons(), get_deals(), etc.
Args: filter_type: Filter by type - 'deals', 'persons', 'org', 'products', 'activities' If not specified, returns all filters.
Returns: JSON array of filters with id, name, and type
Examples: - get_filters() - Get all saved filters - get_filters(filter_type="persons") - Get only person/contact filters - get_filters(filter_type="deals") - Get only deal filters
Inputs: filter_type. Returns: result
get_organizationA
Get a single organization by ID.
Retrieves comprehensive information about a specific organization including all custom fields.
Args: org_id: The Pipedrive organization ID
Returns: JSON object with organization details
Examples: - get_organization(org_id=789) - Get organization with ID 789
Inputs: org_id (required). Returns: result
get_organization_fieldsA
Get all organization field definitions from Pipedrive.
Returns field metadata that maps the hash IDs to human-readable names. Essential for understanding custom fields in organization data.
Returns: JSON array of field definitions with key, name, field_type, and options
Examples: - get_organization_fields() - Get all organization field definitions
Inputs: no named parameters. Returns: result
get_organizationsB
Get all organizations from Pipedrive.
Retrieves all organizations/companies with their details. Use filter_id to apply a saved filter for custom field filtering.
Args: filter_id: ID of a saved filter from Pipedrive (use get_filters to see available filters) limit: Maximum number of organizations to return (default: 500)
Returns: JSON array of organizations
Examples: - get_organizations() - Get all organizations - get_organizations(limit=100) - Get first 100 organizations - get_organizations(filter_id=8) - Get organizations matching saved filter #8
Inputs: filter_id, limit. Returns: result
get_personA
Get a single person/contact by ID.
Retrieves comprehensive information about a specific contact including all custom fields and related data.
Args: person_id: The Pipedrive person ID
Returns: JSON object with person details
Examples: - get_person(person_id=456) - Get person with ID 456
Inputs: person_id (required). Returns: result
get_person_fieldsA
Get all person/contact field definitions from Pipedrive.
Returns field metadata that maps the hash IDs to human-readable names. Essential for understanding custom fields in person data.
Returns: JSON array of field definitions with key, name, field_type, and options
Examples: - get_person_fields() - Get all person field definitions
Inputs: no named parameters. Returns: result
get_personsB
Get all persons/contacts from Pipedrive.
Retrieves all contacts with their details including custom fields. Use filter_id to apply a saved filter for custom field filtering.
Args: filter_id: ID of a saved filter from Pipedrive (use get_filters to see available filters). Create filters in Pipedrive UI to filter by custom fields like "User Type". limit: Maximum number of persons to return (default: 500)
Returns: JSON array of persons
Examples: - get_persons() - Get all contacts - get_persons(limit=100) - Get first 100 contacts - get_persons(filter_id=12) - Get contacts matching saved filter #12
Inputs: filter_id, limit. Returns: result
get_pipelineC
Get a single pipeline by ID.
Retrieves details about a specific pipeline.
Args: pipeline_id: The Pipedrive pipeline ID
Returns: JSON object with pipeline details
Examples: - get_pipeline(pipeline_id=1) - Get pipeline with ID 1
Inputs: pipeline_id (required). Returns: result
get_pipelinesA
Get all pipelines from Pipedrive.
Retrieves all sales pipelines configured in your Pipedrive account.
Returns: JSON array of pipelines
Examples: - get_pipelines() - Get all pipelines
Inputs: no named parameters. Returns: result
get_stagesA
Get all stages, optionally filtered by pipeline.
Retrieves all stages across pipelines. Can filter to show only stages for a specific pipeline.
Args: pipeline_id: Optional pipeline ID to filter stages
Returns: JSON array of stages with pipeline information
Examples: - get_stages() - Get all stages across all pipelines - get_stages(pipeline_id=1) - Get stages for pipeline 1
Inputs: pipeline_id. Returns: result
get_usersA
Get all users/owners from Pipedrive.
Returns all users in your Pipedrive account with their ID, name, email, active status, and role. Useful for filtering deals by owner.
Returns: JSON array of users
Examples: - get_users() - Get all users to see available owners
Inputs: no named parameters. Returns: result
search_allA
Search across all item types in Pipedrive.
Performs a cross-type search across deals, persons, organizations, products, files, activities, and leads.
Args: term: Search term item_types: Comma-separated item types to search (deal, person, organization, product, file, activity, lead). If not specified, searches all types. limit: Maximum results (default: 100)
Returns: JSON array of matching items across types
Examples: - search_all(term="acme") - Search "acme" across all types - search_all(term="enterprise", item_types="deal,person") - Search specific types
Inputs: term (required), item_types, limit. Returns: result
search_dealsA
Full-text search deals by term.
Searches across deal titles, notes, and related content.
Args: term: Search term limit: Maximum results (default: 100)
Returns: JSON array of matching deals
Examples: - search_deals(term="acme") - Search for deals mentioning "acme" - search_deals(term="enterprise", limit=50) - Search with limit
Inputs: term (required), limit. Returns: result
search_leadsB
Full-text search leads by term.
Searches across lead titles and related content.
Args: term: Search term limit: Maximum results (default: 100)
Returns: JSON array of matching leads
Examples: - search_leads(term="startup") - Search for leads mentioning "startup"
Inputs: term (required), limit. Returns: result
search_organizationsA
Full-text search organizations by term.
Searches across organization names and other fields.
Args: term: Search term limit: Maximum results (default: 100)
Returns: JSON array of matching organizations
Examples: - search_organizations(term="acme") - Search for Acme organizations
Inputs: term (required), limit. Returns: result
search_personsC
Full-text search persons/contacts by term.
Searches across person names, emails, phone numbers, and notes.
Args: term: Search term limit: Maximum results (default: 100)
Returns: JSON array of matching persons
Examples: - search_persons(term="john") - Search for persons named John - search_persons(term="@acme.com") - Search by email domain
Inputs: term (required), limit. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 22 tools
Every tool has a clearly distinct purpose: separate retrieval functions for individual entities vs. lists, dedicated search tools, and metadata helpers. There is no functional overlap that would cause an agent to select the wrong tool.
All tools follow a consistent verb_noun pattern (get_X, search_X) using snake_case, with no deviations. This makes the API predictable and easy to navigate.
22 tools is slightly above the typical 3-15 range, but it is justified by the breadth of Pipedrive's data model (deals, persons, organizations, activities, pipelines, etc.) and the need for both single-entity and list retrieval endpoints.
The entire tool surface is read-only. There are no create, update, delete, or mutation operations, which is a significant gap for a CRM management use case. Agents cannot perform any write actions, limiting the server's utility.
Maintenance
Related MCP Connectors
Create contacts, move deals, send proposals and invoices, read your inbox, from Claude or ChatGPT.
Operate the Plixana CRM from any AI: contacts, deals, quotes, WhatsApp and metrics.
Solk CRM for Claude: accounts, pipeline, visits, quotes, orders and tickets with your permissions.
Read deals, persons, organizations, activities and pipelines; create and update CRM records.
CRM1
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides full CRUD access to Pipedrive CRM API, enabling Claude and other LLM applications to manage deals, persons, organizations, activities, notes, and leads with advanced filtering and fuzzy search capabilities.6MIT
- AlicenseBqualityBmaintenanceProvides comprehensive access to Pipedrive CRM with 100+ tools for managing deals, contacts, organizations, activities, and sales workflows through natural language conversations with Claude.303101 npm12MIT
- AlicenseBqualityBmaintenanceEnables users to manage Pipedrive CRM data including deals, contacts, and activities directly through an AI assistant. It supports full CRUD operations, email engagement analysis, and mapping of custom field metadata for comprehensive pipeline management.123225 npm10MIT
- AlicenseBqualityCmaintenanceEnables read-only access to Pipedrive data including deals, persons, organizations, and pipelines, allowing LLMs like Claude to query and analyze CRM information through natural language.16118 npm60MIT