谷歌联系mcp
用于Google联系人的MCP服务器-列表、搜索和管理联系人。
用例
电子邮件查询：“查看最新的JIRA票证。我们可以给安全团队的Sarah发电子邮件，征求他们的意见吗？”→ 查找Sarah的电子邮件并起草邮件。
名片采集：社交活动结束后，拍摄名片照片→ 你的助手提取细节，并将其添加为联系人，并附上你在哪里见过的便条。
查找连接：“我在谷歌认识谁？”或“我下周要去伦敦——我应该找谁？”→ 搜索您的个人网络。
来电提醒：“提醒我下午3点给迈克打电话”→ 创建一个附有Mike电话号码的日历事件，以便您可以直接从提醒中拨号。
联系人更新：你收到一封不在办公室的邮件，说有人带着一封新的个人电子邮件离开了公司→ 你的助手会自动更新他们的联系人。
（这些只是示例-任何需要联系人查找或管理的工作流都可以使用此功能。）
设置
1.创建Google OAuth凭据
- 首选 谷歌云控制台
- 创建新项目（或使用现有项目）
- 启用人民API
- 首选 API和服务 → OAuth同意屏幕，设置同意屏幕
- 首选 API和服务 → 凭证 → 创建凭据 → OAuth客户端ID
- 选择 Web应用程序
- 添加
http://localhost:3000/callback到 授权重定向URI - 记下您的客户端ID和客户端密码
2.运行服务器
GOOGLE_CLIENT_ID='your-client-id' \
GOOGLE_CLIENT_SECRET='your-client-secret' \
MCP_TRANSPORT=http \
npm start服务器运行在 http://localhost:3000 默认情况下。更改为 PORT=3001.
3.添加到您的MCP客户端
claude mcp add --transport http google-contacts-mcp http://localhost:3000/mcp建筑
此服务器充当 OAuth代理 谷歌：
graph LR
A[MCP client] B[google-contacts-mcp] C[Google OAuth/API]- 服务器通过以下方式将自己宣传为OAuth授权服务器
/.well-known/oauth-authorization-server /register返回Google OAuth客户端凭据/authorize重定向到Google，将客户端的回调URL编码为状态/callback从Google接收代码并转发给客户端的回调/token向Google代理令牌请求，注入客户端凭据/mcp处理MCP请求，使用承载令牌调用People API
服务器不持有令牌或状态，它只是将OAuth代理给谷歌。
工具
| 工具 | 说明 |
|---|---|
contacts_list | 列出联系人姓名、电子邮件、电话和组织 |
contacts_search | 按姓名、电子邮件或电话搜索联系人 |
directory_search | 在组织目录中搜索同事 |
contact_get | 获取单个联系人的详细信息 |
contact_create | 创建新联系人 |
contact_update | 更新现有联系人 |
contact_delete | 永久删除联系人 |
贡献
GitHub上欢迎拉取请求！开始：
- 安装Git和Node.js
- 克隆仓库
- 安装依赖项
npm install - 跑
npm run test运行测试 - 建立
npm run build
发布
版本遵循 语义版本规范.
要发布：
- 使用
npm version升级版本 - 跑
git push --follow-tags使用标签推送 - 等待GitHub Actions发布到NPM注册表。