Pipedrive CRM MCP Server

Name: Pipedrive CRM MCP Server
Author: io.github.ckalima

io.github.ckalima/pipedrive-mcp-server

Repository Registry

What is the Pipedrive CRM MCP server?

MCP server for Pipedrive CRM. 155 tools for deals, persons, organizations, activities, and more.

How to install Pipedrive CRM

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

PIPEDRIVE_API_KEY
required
secret
Your 40-character Pipedrive API token (Settings > Personal preferences > API).
PIPEDRIVE_MODE
Server-enforced capability tier: 'read-only' (reads only), 'safe-write' (reads + non-destructive writes; the default), or 'full' (all tools, including destructive). Out-of-mode tools are hidden from tools/list and refused if called directly. A blank value is treated as unset (defaults to safe-write); an unrecognized value falls back to read-only.
PIPEDRIVE_ENABLE_DESTRUCTIVE
Legacy flag, superseded by PIPEDRIVE_MODE. When PIPEDRIVE_MODE is unset, 'true' maps to full; otherwise prefer PIPEDRIVE_MODE=full. Still honored for back-compat.
PIPEDRIVE_IMAGE_BASE_DIR
Allowlisted directory the server may read product images from when a file_path is passed to the image-upload tools. Filesystem reads are disabled unless this is set, and a file_path must resolve within it.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "pipedrive-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@ckalima/pipedrive-mcp-server"
      ],
      "env": {
        "PIPEDRIVE_API_KEY": "<YOUR_PIPEDRIVE_API_KEY>",
        "PIPEDRIVE_MODE": "<YOUR_PIPEDRIVE_MODE>",
        "PIPEDRIVE_ENABLE_DESTRUCTIVE": "<YOUR_PIPEDRIVE_ENABLE_DESTRUCTIVE>",
        "PIPEDRIVE_IMAGE_BASE_DIR": "<YOUR_PIPEDRIVE_IMAGE_BASE_DIR>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "pipedrive-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@ckalima/pipedrive-mcp-server"
      ],
      "env": {
        "PIPEDRIVE_API_KEY": "<YOUR_PIPEDRIVE_API_KEY>",
        "PIPEDRIVE_MODE": "<YOUR_PIPEDRIVE_MODE>",
        "PIPEDRIVE_ENABLE_DESTRUCTIVE": "<YOUR_PIPEDRIVE_ENABLE_DESTRUCTIVE>",
        "PIPEDRIVE_IMAGE_BASE_DIR": "<YOUR_PIPEDRIVE_IMAGE_BASE_DIR>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pipedrive-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@ckalima/pipedrive-mcp-server"
      ],
      "env": {
        "PIPEDRIVE_API_KEY": "<YOUR_PIPEDRIVE_API_KEY>",
        "PIPEDRIVE_MODE": "<YOUR_PIPEDRIVE_MODE>",
        "PIPEDRIVE_ENABLE_DESTRUCTIVE": "<YOUR_PIPEDRIVE_ENABLE_DESTRUCTIVE>",
        "PIPEDRIVE_IMAGE_BASE_DIR": "<YOUR_PIPEDRIVE_IMAGE_BASE_DIR>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "pipedrive-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ckalima/pipedrive-mcp-server"
      ],
      "env": {
        "PIPEDRIVE_API_KEY": "<YOUR_PIPEDRIVE_API_KEY>",
        "PIPEDRIVE_MODE": "<YOUR_PIPEDRIVE_MODE>",
        "PIPEDRIVE_ENABLE_DESTRUCTIVE": "<YOUR_PIPEDRIVE_ENABLE_DESTRUCTIVE>",
        "PIPEDRIVE_IMAGE_BASE_DIR": "<YOUR_PIPEDRIVE_IMAGE_BASE_DIR>"
      }
    }
  }
}

Claude Code

claude mcp add pipedrive-mcp-server --env PIPEDRIVE_API_KEY=<YOUR_PIPEDRIVE_API_KEY> --env PIPEDRIVE_MODE=<YOUR_PIPEDRIVE_MODE> --env PIPEDRIVE_ENABLE_DESTRUCTIVE=<YOUR_PIPEDRIVE_ENABLE_DESTRUCTIVE> --env PIPEDRIVE_IMAGE_BASE_DIR=<YOUR_PIPEDRIVE_IMAGE_BASE_DIR> -- npx -y @ckalima/pipedrive-mcp-server