Skip to main content
Glama
expertintegrado

Pipedrive MCP

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PIPEDRIVE_API_KEYYesYour Pipedrive personal API token.
PIPEDRIVE_TIMEZONENoTimezone for Pipedrive (IANA name).America/Sao_Paulo

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

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