# Pipedrive MCP server

> Lets an AI client read Pipedrive CRM deals, persons, organizations, pipelines, stages, leads, and notes, with optional preview-first writes.

- Repository: https://github.com/WillDent/pipedrive-mcp-server
- Page: https://hostedmcp.org/servers/willdent/pipedrive-mcp-server
- Transport: —
- Stars: 60
- License: MIT

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `MCP_ALLOWED_HOSTS` | no | no |  |
| `MCP_ALLOWED_ORIGINS` | no | no |  |
| `MCP_HOST` | no | no |  |
| `MCP_JWT_SECRET` | no | no |  |
| `MCP_TRANSPORT` | no | no |  |
| `PIPEDRIVE_API_TOKEN` | no | no |  |
| `PIPEDRIVE_WRITE_TOOLS` | no | no |  |

## Tools (3)

- `get-users`
- `get`
- `search`

## FAQ

### Which Pipedrive entities can the MCP server read?

It reads deals, persons, organizations, pipelines, stages, leads, notes, and users, plus a cross-entity search. Deals, persons, organizations, pipelines, stages, and leads use API v2, while notes and users use v1 adapters.

### How do I enable write tools in the Pipedrive MCP server?

Writes are off unless you name them in the PIPEDRIVE_WRITE_TOOLS environment variable, and they preview unless execute is true. The available tools are move-deal and add-deal-note.

### How does the Pipedrive MCP server authenticate to Pipedrive?

It uses a Pipedrive API token supplied through the PIPEDRIVE_API_TOKEN environment variable. OAuth is explicitly out of scope.

### Does the Pipedrive MCP server support Docker?

Yes, Docker Compose publishes the service on host loopback by default and requires a JWT secret for MCP routes. You can also run it with stdio in Docker by overriding the transport and disabling the health check.
