convez.ai
MCP ServerIntegração & APIsIntermediário
ckalima

Pipedrive MCP Server

ckalima/pipedrive-mcp-server

Integração completa do Pipedrive CRM para Claude com operações full-stack

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra o Pipedrive CRM diretamente com Claude, permitindo consultar, criar e atualizar deals, contatos, organizações e atividades. Inclui análise de emails, descoberta de campos customizados e gerenciamento de pipelines com suporte a paginação.

Instalação

$npx convez-ai ckalima/pipedrive-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
10
Forks
2
Acompanhando
0
Saúde
57%
Último commit
há 5 dias
Versão
v2.7.1
Issues abertas
2
Contribuidores
1

Casos de uso

  • Consultar e atualizar deals diretamente do chat com Claude
  • Criar contatos e organizações automaticamente via IA
  • Analisar threads de email associados a deals e pessoas
  • Descobrir e mapear campos customizados do CRM
  • Gerenciar pipelines, estágios e equipes programaticamente

Veredito

MCP server robusto e bem estruturado para quem precisa integrar Pipedrive com Claude. Cobertura ampla de operações CRM (deals, contatos, atividades, emails) com suporte a campos customizados. Ótimo para automação de vendas e gestão de relacionamento via IA.

README

A tradução para o português deste README ainda está na fila.

Pipedrive MCP Server

An MCP (Model Context Protocol) server for Pipedrive CRM integration with Claude Code and Claude Desktop. Query, create, and update CRM data directly from your AI assistant.

Features

  • Full CRM Operations: Deals, persons, organizations, activities
  • Email Analysis: Access mail threads and messages for engagement analysis
  • Field Discovery: Map custom field hash codes to human-readable names
  • Pipeline Management: List pipelines, stages, and users
  • Pagination Support: Cursor-based pagination for large datasets
  • Error Handling: Clear, actionable error messages

Quick Start

1. Get Your Pipedrive API Key

  1. Log into Pipedrive
  2. Go to Settings > Personal preferences > API
  3. Copy your API key (40 characters)

2. Configure Claude Code

Add to your .mcp.json file:

{
  "mcpServers": {
    "pipedrive": {
      "command": "npx",
      "args": ["-y", "pipedrive-mcp-server"],
      "env": {
        "PIPEDRIVE_API_KEY": "your-40-character-api-key"
      }
    }
  }
}

Or set the environment variable:

export PIPEDRIVE_API_KEY="your-40-character-api-key"

3. Start Using

Once configured, Claude can access your Pipedrive data:

  • "Show me open deals worth more than $10,000"
  • "Create a deal called 'Acme Contract' with value $50,000"
  • "Find all contacts at TechCorp"
  • "List recent email threads in my inbox"
  • "What custom fields are defined for deals?"

Available Tools

Core CRM Operations (Tier 1)

ToolDescription
pipedrive_list_dealsList deals with filtering (owner, person, org, pipeline, stage, status)
pipedrive_get_dealGet deal details by ID
pipedrive_create_dealCreate new deal
pipedrive_update_dealUpdate existing deal
pipedrive_search_dealsSearch deals by text
pipedrive_list_personsList persons with filtering
pipedrive_get_personGet person details
pipedrive_create_personCreate new person
pipedrive_update_personUpdate existing person
pipedrive_search_personsSearch persons by name/email/phone
pipedrive_list_activitiesList activities with filtering
pipedrive_create_activityCreate new activity
pipedrive_update_activityUpdate/complete activity

Email/Mail Tools (Tier 2)

ToolDescription
pipedrive_get_person_emailsGet mail messages for a person
pipedrive_get_deal_emailsGet mail messages for a deal
pipedrive_list_mail_threadsList mail threads by folder
pipedrive_get_mail_threadGet thread with messages
pipedrive_get_mail_messageGet full message body

Field Metadata (Tier 3)

ToolDescription
pipedrive_list_organization_fieldsAll org field definitions
pipedrive_list_deal_fieldsAll deal field definitions
pipedrive_list_person_fieldsAll person field definitions
pipedrive_get_fieldGet field by key

Supporting Resources (Tier 4)

ToolDescription
pipedrive_list_organizationsList organizations
pipedrive_get_organizationGet organization details
pipedrive_create_organizationCreate organization
pipedrive_search_organizationsSearch organizations
pipedrive_list_pipelinesList all pipelines
pipedrive_list_stagesList stages in pipeline
pipedrive_list_usersList users
pipedrive_get_userGet user details
pipedrive_get_current_userGet API key owner

Example Workflows

Analyze Deal Pipeline

"Show me all open deals in the Sales pipeline, sorted by value"
"Get details for deal 12345 including custom fields"
"Move deal 12345 to the Proposal stage"

Customer Research

"Find contacts at Acme Corp"
"Get emails for person 456 to analyze their engagement"
"What custom fields do we have for persons?"

Activity Management

"List my overdue activities"
"Create a follow-up call with John Smith for tomorrow at 2pm"
"Mark activity 789 as done"

Field Discovery

"List all custom fields for deals"
"What does field '8a4d7f...' mean?" (40-char hash)

Development

Local Setup

git clone https://github.com/ckalima/pipedrive-mcp-server.git
cd pipedrive-mcp-server
npm install
cp .env.example .env
# Edit .env with your API key

Build & Run

npm run build
npm run start

Development Mode

npm run dev

Test with MCP Inspector

npx @modelcontextprotocol/inspector node dist/index.js

API Versioning

This server uses both Pipedrive API versions:

  • v2 (/api/v2): Deals, Persons, Organizations, Activities
  • v1 (/v1): Mail, Fields, Pipelines, Stages, Users

The client automatically routes to the correct version.

Error Handling

Errors are returned with actionable suggestions:

{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "API key is invalid or expired",
    "suggestion": "Verify your API key at Pipedrive Settings > Personal preferences > API"
  }
}

Common error codes:

  • MISSING_API_KEY - Set PIPEDRIVE_API_KEY environment variable
  • INVALID_API_KEY - Check your API key in Pipedrive settings
  • NOT_FOUND - The requested resource doesn't exist
  • RATE_LIMITED - Wait 60 seconds before retrying
  • VALIDATION_ERROR - Check your request parameters

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT - see LICENSE

Links

Ver o original no GitHub

Bom para

Relacionados