Pipedrive MCP Server

This is a Model Context Protocol (MCP) server that provides read-only access to Pipedrive CRM data. The server exposes Pipedrive API functionality through MCP tools and prompts, allowing LLM applications like Claude or Github Copilot to interact with Pipedrive data.

Features

• Read-only access to Pipedrive data
• Dual API support (v1 and v2 endpoints)
• Wide entity coverage: deals, persons, organizations, pipelines, activities, products, files, stages, notes, email threads
• Includes all fields including custom fields
• Predefined prompts for common CRM analysis tasks
• Modular architecture with clean separation of concerns

Using with Claude

To use this server with Claude for Desktop:

1. Configure Claude for Desktop by editing your claude_desktop_config.json:

{
  "mcpServers": {
    "pipedrive": {
      "command": "bunx",
      "args": ["pipedrive-mcp@latest"],
      "env": {
        "PIPEDRIVE_API_TOKEN": "<YOUR_API_TOKEN>"
      }
    }
  }
}

2. Restart Claude for Desktop
3. In the Claude application, you should now see the Pipedrive tools available

Available Tools

Core Entity Management

• get-deals / get-deal / search-deals: Deal management with custom fields
• get-persons / get-person / search-persons: Contact operations with custom fields
• get-organizations / get-organization / search-organizations: Organization management with custom fields
• get-pipelines / get-pipeline: Pipeline operations
• get-stages / get-stage / get-pipeline-stages: Pipeline stage operations

Activities & Products (v2 API)

• get-activities / get-activity: Activity operations with sorting options
• get-activities-by-deal / get-activities-by-person / get-activities-by-organization: Entity-specific activities
• get-activity-deal / get-activity-person / get-activity-organization: Get entities associated with activities
• get-products / get-product / search-products: Product management
• get-deal-products: Products associated with deals

Content & Communication

• get-files / get-file: File management operations
• get-notes / get-note: Notes management
• get-mail-threads / get-mail-thread / get-mail-thread-messages / get-mail-message: Email operations

Search & Discovery

• search-leads: Search leads by term
• search-all: Search across all item types (deals, persons, organizations, products, files, activities, leads)
• get-recents: Recently accessed items

Available Prompts

• list-all-deals: List all deals in Pipedrive
• list-all-persons: List all persons in Pipedrive
• list-all-pipelines: List all pipelines in Pipedrive
• analyze-deals: Analyze deals by stage
• analyze-contacts: Analyze contacts by organization
• analyze-leads: Analyze leads by status
• compare-pipelines: Compare different pipelines and their stages
• find-high-value-deals: Find high-value deals

License

MIT