Pipedrive MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PIPEDRIVE_API_KEY | Yes | Your Pipedrive personal API token. | |
| PIPEDRIVE_TIMEZONE | No | Timezone for Pipedrive (IANA name). | America/Sao_Paulo |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_dealsA | Lista negócios do Pipedrive. Pode filtrar por status e pipeline. Suporta paginação via start/limit e busca automática de todos os registros via buscar_todos. |
| search_dealsA | Busca negócios por termo (título, contato, empresa). |
| get_dealA | Retorna dados e campos personalizados de um deal. Para análise completa (com atividades, notas, pessoa e histórico), prefira get_deal_summary. |
| create_dealA | Cria negócio quando pessoa e org já existem (IDs conhecidos). Para novos leads, prefira create_deal_full. Aceita nome ou ID para pipeline, etapa e responsável. Verifica deals abertos. |
| create_deal_fullA | PREFERENCIAL para criar novos deals. Cria deal completo em uma chamada: pessoa + organização + deal + atividades. Busca duplicatas automaticamente. Propaga origem para pessoa (1x, nunca muda) e deal. Aceita nome ou ID para pipeline, etapa e responsável. Sempre usar este tool ao registrar um novo lead/oportunidade. |
| update_dealC | Atualiza um negócio (status, etapa, pipeline, valor, etc.). Aceita nome ou ID para pipeline, etapa e responsável. |
| get_deal_flowA | Histórico detalhado de mudanças de um deal (status, etapa, motivo perda). Para visão completa do deal, prefira get_deal_summary. |
| get_deal_summaryA | PREFERENCIAL para analisar deals. Retorna visão completa em uma chamada: dados do deal, campos personalizados, pessoa vinculada (telefone, email, origem), atividades (feitas + pendentes + atrasadas), notas e histórico de movimentação com tempo na etapa atual. Sempre usar este tool ao analisar um negócio. |
| create_noteB | Cria uma nota em um negócio, contato ou organização. O conteúdo suporta HTML. |
| update_noteA | Edita o conteúdo de uma nota existente e/ou pina/despina no deal. O conteúdo suporta HTML. |
| list_deal_notesA | Lista notas de um deal. Para visão completa (com atividades, campos e histórico), prefira get_deal_summary. |
| search_personsA | Busca contatos por nome, email ou telefone. |
| get_personA | Retorna detalhes completos de um contato pelo ID. |
| create_personA | Cria um novo contato no Pipedrive. IMPORTANTE: Antes de criar, o MCP busca automaticamente por duplicatas (últimos 8 dígitos do telefone E email em paralelo). Se encontrar, retorna aviso com link em vez de criar. |
| update_personA | Atualiza um contato (nome, email, telefone, organização). IMPORTANTE: Antes de atualizar, verifica campos existentes e avisa sobre possíveis sobrescritas. Email e telefone são ADICIONADOS (não substituem os existentes). |
| search_organizationsC | Busca organizações/empresas no Pipedrive. |
| get_organizationA | Retorna detalhes completos de uma organização pelo ID. |
| create_organizationA | Cria organização isolada. Para novos leads, prefira create_deal_full (já cria org junto). Verifica duplicatas automaticamente. |
| list_activitiesA | Lista atividades do Pipedrive. Pode filtrar por usuário, tipo, período (due_date), negócio e status. Inclui indicador 'atrasada' para atividades vencidas. Quando start_date/end_date são fornecidos, busca automaticamente todas as páginas e filtra por due_date no lado do servidor. |
| list_deal_activitiesA | Lista atividades de um deal com filtro por status. Para visão completa do deal, prefira get_deal_summary. |
| create_activityA | Cria uma nova atividade/tarefa no Pipedrive. Aceita nome ou alias para tipo e responsável (resolve automaticamente). Horários em fuso local (converte para UTC). Se deal_id ou person_id informado, verifica atividades pendentes antes de criar. |
| update_activityB | Atualiza uma atividade: marcar como feita, reagendar, mudar responsável ou tipo. Aceita nome ou ID para tipo e responsável. Horários em fuso local. |
| list_productsC | Lista os produtos disponíveis no Pipedrive. |
| add_product_to_dealC | Vincula um produto a um negócio. |
| update_deal_fieldsA | Atualiza campos personalizados de um negócio. Passe um JSON com o nome do campo e o valor. Para campos enum, use o texto exato da opção. Para set (múltipla escolha), separe por vírgula. IMPORTANTE: Se um campo já tiver valor preenchido, a ferramenta NÃO vai sobrescrever — vai retornar os conflitos para você perguntar ao usuário. Use force=true SOMENTE após confirmação explícita do usuário. |
| sync_allA | Sincroniza TUDO do Pipedrive em um único config.js: campos de deals, campos de contatos, tipos de atividade, pipelines, etapas, usuários e domínio. Execute após instalar o MCP pela primeira vez ou quando alterar configurações no Pipedrive. O config.js gerado pode ser distribuído para funcionários. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/expertintegrado/pipedrive-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server