{"id":50352590,"url":"https://github.com/expertintegrado/pipedrive-mcp","last_synced_at":"2026-05-29T21:30:32.227Z","repository":{"id":353178737,"uuid":"1218296215","full_name":"expertintegrado/pipedrive-mcp","owner":"expertintegrado","description":"Servidor MCP oficial da Expert Integrado para o CRM Pipedrive — 24 ferramentas para negocios, contatos, atividades e notas, com guardrails anti-duplicata e protecao contra sobrescrita.","archived":false,"fork":false,"pushed_at":"2026-05-11T23:29:00.000Z","size":119,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-29T00:23:48.323Z","etag":null,"topics":["anthropic","claude","claude-code","claude-desktop","crm","expert-integrado","mcp","model-context-protocol","nodejs","pipedrive","pipedrive-crm"],"latest_commit_sha":null,"homepage":"https://github.com/expertintegrado/pipedrive-mcp#readme","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/expertintegrado.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-22T18:23:34.000Z","updated_at":"2026-05-11T23:29:05.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/expertintegrado/pipedrive-mcp","commit_stats":null,"previous_names":["expertintegrado/pipedrive-mcp"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/expertintegrado/pipedrive-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/expertintegrado%2Fpipedrive-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/expertintegrado%2Fpipedrive-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/expertintegrado%2Fpipedrive-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/expertintegrado%2Fpipedrive-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/expertintegrado","download_url":"https://codeload.github.com/expertintegrado/pipedrive-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/expertintegrado%2Fpipedrive-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33672124,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-29T02:00:06.066Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["anthropic","claude","claude-code","claude-desktop","crm","expert-integrado","mcp","model-context-protocol","nodejs","pipedrive","pipedrive-crm"],"created_at":"2026-05-29T21:30:31.478Z","updated_at":"2026-05-29T21:30:32.213Z","avatar_url":"https://github.com/expertintegrado.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pipedrive MCP\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![npm version](https://img.shields.io/npm/v/@expertintegrado/pipedrive-mcp.svg)](https://www.npmjs.com/package/@expertintegrado/pipedrive-mcp)\n\nConecta o seu **Pipedrive** ao **Claude Code**. Depois de instalar, você pede coisas como *\"cria um deal pro cliente X\"*, *\"quais atividades eu tenho hoje?\"*, *\"adiciona uma nota no deal 123\"* — e ele faz, direto no seu Pipedrive.\n\n\u003e A instalação é guiada pelo próprio Claude Code. Você só cola um prompt e passa seu token quando ele pedir. Não precisa editar arquivo, não precisa mexer em terminal.\n\n---\n\n## Passo 1 — Instale o que precisa\n\nBaixe e instale (uma vez só, na sua máquina):\n\n- [Node.js 18 ou superior](https://nodejs.org/) — baixe e clique \"Avançar\" até o fim. **Reinicie o computador** depois.\n- [Claude Code](https://claude.ai/download) — o aplicativo oficial da Anthropic.\n\n## Passo 2 — Pegue seu token do Pipedrive\n\n1. Entre no seu Pipedrive\n2. Clique na sua **foto de perfil** (canto superior direito)\n3. Vá em **Configurações** \u003e **Preferências pessoais** \u003e **API**\n4. Copie o **token da API pessoal** (uma sequência longa de letras e números)\n\nGuarde esse token — o Claude vai pedir no próximo passo.\n\n\u003e **Cuidado:** esse token dá acesso ao SEU Pipedrive. Não compartilhe, não poste em grupo, não mande por e-mail. Cada pessoa deve pegar o próprio token.\n\n## Passo 3 — Peça pro Claude Code instalar\n\nAbra o **Claude Code** e cole o prompt abaixo no chat (use o botão de copiar no canto do bloco):\n\n````text\nVocê é um instalador automático do MCP do Pipedrive da Expert Integrado.\nSiga esta sequência:\n\n1. Me pergunte no chat qual é o meu token da API do Pipedrive e\n   aguarde minha resposta antes de continuar. Não use nenhum valor\n   de exemplo — precisa ser o token real que eu vou colar.\n\n2. Com o token em mãos, rode no terminal exatamente:\n\n   claude mcp add pipedrive -s user \\\n     -e PIPEDRIVE_API_KEY=\u003cTOKEN_QUE_EU_PASSEI\u003e \\\n     -e PIPEDRIVE_TIMEZONE=America/Sao_Paulo \\\n     -- npx -y @expertintegrado/pipedrive-mcp\n\n   Substituindo \u003cTOKEN_QUE_EU_PASSEI\u003e pelo token que eu respondi no\n   passo 1.\n\n3. Baixe e leia a documentação completa do MCP rodando:\n\n   npm view @expertintegrado/pipedrive-mcp readme\n\n   O README descreve o que o MCP faz, as ferramentas disponíveis,\n   exemplos de uso e regras importantes. Use esse conteúdo como\n   contexto pra me ajudar a usar o Pipedrive daqui pra frente —\n   você não precisa me mostrar o README inteiro, só absorver\n   internamente.\n\n4. Confirme que tudo rodou sem erro e me avise pra encerrar e\n   reabrir o Claude Code pra ativar o MCP.\n````\n\nO Claude Code vai:\n\n1. Te perguntar o token → você cola o que pegou no Passo 2\n2. Rodar o comando de configuração automaticamente\n3. Baixar o README do pacote pra ter contexto completo do MCP\n4. Te avisar pra reiniciar\n\nQuando ele pedir, **feche e abra o Claude Code** (feche o app inteiro, não só a aba).\n\n## Passo 4 — Teste\n\nCom o Claude Code reaberto, pergunte:\n\n\u003e Lista os meus deals abertos no Pipedrive.\n\nSe ele responder com os deals, tá funcionando. 🎉\n\n## Passo 5 — (Recomendado) Sincronize os dados da sua conta\n\nPeça ao Claude Code, **uma vez só**:\n\n\u003e Execute o `sync_all` do Pipedrive.\n\nIsso faz o MCP aprender os campos, pipelines, etapas e tipos de atividade da sua conta — respostas passam a usar nomes legíveis ao invés de números internos. Se você criar campos/pipelines novos lá no Pipedrive depois, repita esse comando.\n\n---\n\n## Atualizando o MCP\n\nQuando sair versão nova, o `npx` pega automaticamente na próxima inicialização — não precisa fazer nada. Se quiser forçar agora, peça ao Claude Code:\n\n\u003e Limpa o cache do npx do Pipedrive MCP (roda `npm cache clean --force`) e me avisa pra reiniciar o Claude Code.\n\nSe a nova versão mudou campos ou pipelines esperados, rode `sync_all` de novo.\n\n## Não funcionou?\n\nCole isso no Claude Code:\n\n\u003e O MCP do Pipedrive da Expert Integrado não está funcionando. Roda `/mcp` pra verificar se ele tá listado, confere se o Node.js 18+ está instalado, e me ajuda a diagnosticar. Se precisar, consulta o guia em `https://github.com/expertintegrado/pipedrive-mcp/blob/main/docs/TROUBLESHOOTING.md`.\n\nSe mesmo assim não rolar, [abra uma issue](https://github.com/expertintegrado/pipedrive-mcp/issues/new/choose) contando o que aconteceu.\n\n## O que dá pra fazer\n\nExemplos depois de instalado:\n\n- *\"Cria um deal chamado 'Empresa X - Plano Premium' pra pessoa Maria Silva\"*\n- *\"Quais atividades eu tenho agendadas pra hoje?\"*\n- *\"Marca uma ligação com o Pedro Santos pra amanhã às 14h\"*\n- *\"Adiciona uma nota no deal 456 dizendo que o cliente pediu desconto de 10%\"*\n- *\"Me mostra o histórico de movimentação do deal 789\"*\n- *\"Busca todos os contatos que trabalham na empresa ABC\"*\n\nLista completa de comandos: [docs/TOOLS.md](docs/TOOLS.md)\n\n## Quer mudar seu fuso horário?\n\nPor padrão usamos `America/Sao_Paulo`. Se você estiver em outro fuso, peça ao Claude Code:\n\n\u003e No MCP do Pipedrive, troca a variável `PIPEDRIVE_TIMEZONE` pra `America/New_York` (ou o nome IANA do fuso que você usa) e reinicie.\n\n## Instalação manual (fallback)\n\n\u003cdetails\u003e\n\u003csummary\u003eSe preferir configurar sem pedir pro Claude Code, clique aqui.\u003c/summary\u003e\n\nRode no terminal (troque `SEU_TOKEN` pelo token do Passo 2):\n\n```bash\nclaude mcp add pipedrive -s user \\\n  -e PIPEDRIVE_API_KEY=SEU_TOKEN \\\n  -e PIPEDRIVE_TIMEZONE=America/Sao_Paulo \\\n  -- npx -y @expertintegrado/pipedrive-mcp\n```\n\nOu, se quiser editar o arquivo de configuração manualmente, adicione ao `~/.claude.json` (Claude Code, user scope) ou ao `.mcp.json` (Claude Code, por projeto):\n\n```json\n{\n  \"mcpServers\": {\n    \"pipedrive\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@expertintegrado/pipedrive-mcp\"],\n      \"env\": {\n        \"PIPEDRIVE_API_KEY\": \"SEU_TOKEN\",\n        \"PIPEDRIVE_TIMEZONE\": \"America/Sao_Paulo\"\n      }\n    }\n  }\n}\n```\n\nReinicie o Claude Code depois.\n\n\u003c/details\u003e\n\n## Instalação alternativa (offline, Claude Desktop, contribuidor)\n\nSe você:\n\n- Está em ambiente **sem internet** (ou com proxy que bloqueia o npm registry)\n- Quer usar o **Claude Desktop** (app de chat) em vez do Claude Code\n- Vai **contribuir com o código** do MCP\n\n→ Veja o [guia técnico de instalação](INSTALL.md) — tem os modos via ZIP download, `git clone`, e a configuração para Claude Desktop e outros clientes MCP.\n\n## Segurança\n\n- Seu token fica **apenas no seu computador**, dentro do arquivo de configuração do Claude\n- Nenhum dado é enviado pra servidor externo — o MCP roda localmente na sua máquina\n- Operações de exclusão são bloqueadas por padrão\n- Campos já preenchidos são protegidos contra sobrescrita acidental\n\n## Contribuindo\n\nQuer reportar um bug, sugerir uma melhoria ou contribuir com código? Veja [CONTRIBUTING.md](CONTRIBUTING.md) e, para o procedimento de release, [RELEASING.md](RELEASING.md).\n\n## Licença\n\n[MIT](LICENSE) © Expert Integrado\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexpertintegrado%2Fpipedrive-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fexpertintegrado%2Fpipedrive-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexpertintegrado%2Fpipedrive-mcp/lists"}