Pipedrive Mcp Server

Pipedrive MCP 服务

由 Binar 构建——可在 MIT 许可证下免费使用。

适用于 Pipedrive CRM 的 MCP（Model Context Protocol）服务。将 Claude Code 或 Claude Desktop 直接连接到你的 Pipedrive 账户，使用自然语言管理 CRM。

"Show me all open deals in the Sales pipeline"
"Create a follow-up call with Acme Corp for tomorrow at 2pm"
"Update John Smith's email address"
"Search for deals related to the enterprise contract"

---

快速开始

1. 获取 Pipedrive API 密钥

1. 登录 Pipedrive
2. 前往 Settings → Personal preferences → API
3. 复制你的个人 API 令牌

2. 配置 Claude Code

将以下内容添加到项目的 .mcp.json：

{
  "mcpServers": {
    "pipedrive": {
      "command": "node",
      "args": ["/path/to/pipedrive-mcp-server/dist/index.js"],
      "env": {
        "PIPEDRIVE_API_KEY": "your-api-token-here"
      }
    }
  }
}

或者，对于 Claude Desktop，将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "pipedrive": {
      "command": "node",
      "args": ["/path/to/pipedrive-mcp-server/dist/index.js"],
      "env": {
        "PIPEDRIVE_API_KEY": "your-api-token-here"
      }
    }
  }
}

3. 构建

git clone https://github.com/binarapps/pipedrive-mcp-server.git
cd pipedrive-mcp-server
npm install
npm run build

---

可用工具

交易

工具	描述
pipedrive_list_deals	列出交易，可按负责人、联系人、组织、销售管道、阶段和状态筛选
pipedrive_get_deal	根据 ID 获取交易详情
pipedrive_create_deal	创建新交易
pipedrive_update_deal	更新现有交易
pipedrive_search_deals	按标题、备注或自定义字段搜索交易
pipedrive_delete_deal	删除交易
pipedrive_get_deal_emails	获取关联到交易的邮件会话

联系人

工具	描述
pipedrive_list_persons	列出联系人，可进行筛选
pipedrive_get_person	根据 ID 获取联系人详情
pipedrive_create_person	创建新联系人
pipedrive_update_person	更新姓名、电子邮件、电话、组织和自定义字段
pipedrive_search_persons	按姓名、电子邮件、电话和自定义字段搜索
pipedrive_delete_person	删除联系人
pipedrive_get_person_emails	获取关联到联系人的邮件会话

组织

工具	描述
pipedrive_list_organizations	列出组织，可进行筛选
pipedrive_get_organization	获取组织详情
pipedrive_create_organization	创建新组织
pipedrive_update_organization	更新现有组织
pipedrive_search_organizations	按名称、地址和自定义字段搜索
pipedrive_delete_organization	删除组织

活动

工具	描述
pipedrive_list_activities	列出活动，可进行筛选
pipedrive_get_activity	获取活动详情
pipedrive_create_activity	创建新活动（电话、会议、任务等）
pipedrive_update_activity	更新活动或将其标记为已完成
pipedrive_delete_activity	删除活动

潜在客户

工具	描述
pipedrive_list_leads	列出潜在客户
pipedrive_get_lead	获取潜在客户详情
pipedrive_create_lead	创建新的潜在客户
pipedrive_update_lead	更新潜在客户
pipedrive_delete_lead	删除潜在客户
pipedrive_search_leads	按标题搜索潜在客户

备注

工具	描述
pipedrive_list_notes	列出备注，可进行筛选
pipedrive_get_note	获取备注详情
pipedrive_create_note	创建新备注
pipedrive_update_note	更新备注
pipedrive_delete_note	删除备注
pipedrive_list_note_comments	列出备注的评论
pipedrive_get_note_comment	根据 ID 获取特定评论
pipedrive_add_note_comment	为备注添加评论
pipedrive_update_note_comment	更新评论内容
pipedrive_delete_note_comment	删除备注评论

邮件 / 邮箱

工具	描述
pipedrive_list_mail_threads	按文件夹列出邮件会话
pipedrive_get_mail_thread	获取邮件会话
pipedrive_get_mail_thread_messages	获取会话中的所有邮件
pipedrive_get_mail_message	获取完整邮件正文
pipedrive_update_mail_thread	将会话关联到交易，或标记为已读/已归档
pipedrive_delete_mail_thread	删除邮件会话

流水线与阶段

工具	描述
pipedrive_list_pipelines	列出所有流水线
pipedrive_get_pipeline	获取流水线详情
pipedrive_create_pipeline	创建新流水线
pipedrive_update_pipeline	更新流水线
pipedrive_delete_pipeline	删除流水线
pipedrive_list_stages	列出流水线中的所有阶段
pipedrive_get_stage	获取阶段详情
pipedrive_create_stage	创建新阶段
pipedrive_update_stage	更新阶段
pipedrive_delete_stage	删除阶段

字段元数据

工具	描述
pipedrive_list_deal_fields	列出所有交易字段定义（包括自定义字段）
pipedrive_list_person_fields	列出所有个人字段定义
pipedrive_list_organization_fields	列出所有组织字段定义
pipedrive_list_activity_fields	列出所有活动字段定义
pipedrive_list_note_fields	列出所有备注字段定义
pipedrive_list_lead_fields	列出所有潜在客户字段定义
pipedrive_get_field	按键获取特定字段（支持：交易、个人、组织、活动）

用户

工具	描述
pipedrive_list_users	列出所有用户
pipedrive_get_user	获取用户详情
pipedrive_get_current_user	获取当前 API 令牌所有者
pipedrive_find_users	按姓名或电子邮件地址查找用户

---

API 版本管理

Pipedrive 正在迁移到 v2。此服务会为每个端点使用合适的版本：

API	端点
v2 (/api/v2)	交易、个人、组织、活动、潜在客户（搜索）、字段、流水线、阶段
v1 (/v1)	潜在客户（增删改查）、备注、邮件／邮箱、用户

---

示例工作流

流水线审查

"Show me all open deals worth over $10k in the Enterprise pipeline"
"Move deal 1234 to the Proposal stage"
"Who owns the most open deals right now?"

联系人管理

"Find all contacts at Acme Corp"
"Update John Smith's email to [email protected]"
"Create a new person: Sarah Connor, [email protected], at org 42"

活动跟踪

"List my overdue activities"
"Mark activity 789 as done"
"Create a follow-up meeting with deal 1234 for next Monday"

自定义字段

"List all custom fields defined for deals"
"What does the field with key 'a8f3c2...' mean?"

---

开发

npm install
npm run build      # compile TypeScript
npm run dev        # watch mode
npm test           # run tests

使用 MCP Inspector 测试：

npx @modelcontextprotocol/inspector node dist/index.js

---

许可证

MIT — 可免费使用、修改和分发。

---

由 Binar 倾力打造 ❤️