quintype/pipedrive-mcp-server

Pipedrive MCP Server

This is a Model Context Protocol (MCP) server that connects to the Pipedrive API v2. It allows you to expose Pipedrive data and functionality to LLM applications like Claude.

Features

• Read-only access to Pipedrive data
• Exposes deals, persons, organizations, and pipelines
• Includes all fields including custom fields
• Predefined prompts for common operations

Setup

1. Clone this repository
2. Install dependencies:

   npm install
   

3. Create a .env file in the root directory with your Pipedrive API token:

   PIPEDRIVE_API_TOKEN=your_api_token_here
   

4. Build the project:

   npm run build
   

5. Start the server:

   npm start
   

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": "node",
      "args": ["/path/to/pipedrive-mcp-server/build/index.js"],
      "env": {
        "PIPEDRIVE_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

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

Available Tools

• get-deals: Get all deals from Pipedrive (including custom fields)
• get-deal: Get a specific deal by ID (including custom fields)
• search-deals: Search deals by term
• get-persons: Get all persons from Pipedrive (including custom fields)
• get-person: Get a specific person by ID (including custom fields)
• search-persons: Search persons by term
• get-organizations: Get all organizations from Pipedrive (including custom fields)
• get-organization: Get a specific organization by ID (including custom fields)
• search-organizations: Search organizations by term
• get-pipelines: Get all pipelines from Pipedrive
• get-pipeline: Get a specific pipeline by ID
• get-stages: Get all stages from all pipelines
• search-leads: Search leads by term
• search-all: Search across all item types (deals, persons, organizations, etc.)

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