AI导哈

Google联系人MCP服务器

一个集成Google联系人与Claude的MCP服务器，支持通过AI助手直接管理联系人。

  • by Hecke-AI
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 Hecke-AI/google-contacts-mcp

使用说明

Google 联系人 MCP 服务器

“我的两个要求是，通过MCP接口与我的谷歌联系人对接，以便轻松添加/更新联系人，并对我的联系人列表进行一些筛选整理。我从2000年代初就积累了750个联系人，其中包括已经停业的出租车服务和那些我不会再联系的人。这个MCP服务器帮我在一个下午就把联系人清理到了297个相关的联系人。”——克里斯·斯皮里托

A. 模型上下文协议（MCP） 将谷歌联系人与Claude集成的服务器，使您能够直接通过您的AI助手进行联系人管理。

边做边学： 这个仓库不仅提供了一个可运行的MCP服务器，还教你如何从零开始构建自己的服务器。

特点/特性

  • 🔍（放大镜图标，常用于表示搜索、查看细节等动作） 搜索联系人 通过姓名、电子邮件或电话
  • 📋 代表“待办事项清单”或“清单”等意思，具体翻译可能根据上下文有所不同。 列出所有联系人 带有分页功能
  • 加号 创建新联系人 附有完整细节
  • 🗑️（垃圾桶） 删除联系人 单独地；个别地
  • 📖 书籍 获取详细的联系方式 包括地址和组织
  • 🔐 安全的OAuth 2.0 认证

实际应用案例

这个MCP服务器的构建旨在解决一个实际问题：联系人数据库清理。在我的20多年专业工作生涯中，我的Google联系人积累了：

  • 十年前活动的老会议联系人
  • 已停业的服务供应商（出租车服务、承包商）
  • 存在格式问题的重复条目
  • 个人联系与职业联系交织在一起
  • 联系方式中信息缺失或过时

使用这个MCP服务器与Claude Code，我：

  1. 分类 750个联系人分成了8个有组织的群组
  2. 已删除 446个过时的联系人自动（被处理/移除）
  3. 已清洁 重复和格式错误的条目
  4. 已审阅 在Excel中高效管理剩余联系人
  5. 减少 几个小时内将我的联系人数据库容量增加了60%

结果？一个干净、易于管理的联系人数据库，其中包含297个相关联系人。

快速入门

先决条件

  • Node.js 18+ 和 npm
  • 一个Google Cloud账户
  • Claude Code（或任何MCP兼容的客户端）

安装

# Clone the repository
git clone https://github.com/yourusername/google-contacts-mcp.git
cd google-contacts-mcp

# Install dependencies
npm install

# Build the TypeScript code
npm run build

设置

  1. 遵循 设置指南 配置Google Cloud OAuth
  2. 添加到Claude Code的MCP设置中 (~/.config/claude-code/mcp_settings.json)：
{
  "mcpServers": {
    "google-contacts": {
      "command": "node",
      "args": ["/path/to/google-contacts-mcp/dist/index.js"]
    }
  }
}
  1. 重启Claude代码 并开始使用Google联系人工具！

可用工具

  • search_contacts - 通过姓名、电子邮件或电话搜索联系人
  • list_contacts - 列出所有联系人并分页显示
  • get_contact - 获取特定联系人的详细信息
  • create_contact - 创建一个新的联系人
  • delete_contact - 通过资源名称删除联系人

文档

示例用法

搜索联系人

You: "Search for contacts named Sarah"
Claude: [uses search_contacts tool]
Found 2 contacts:
- Sarah Johnson (sarah.johnson@example.com)
- Sarah Martinez (smartinez@techcorp.com)

创建一个新的联系人

You: "Add a contact for Hans Mueller, senior engineer at SwissTech, email h.mueller@swisstech.ch, phone +41 44 123 4567"
Claude: [uses create_contact tool]
Contact created successfully for Hans Mueller.

删除过时的联系人

You: "Delete all contacts from the 2015 conference in Berlin"
Claude: [searches, confirms, then uses delete_contact for each]
Deleted 12 contacts from the conference attendee list.

教育价值

这个仓库旨在教你：

  1. MCP协议基础 - 理解工具定义和处理器
  2. OAuth 2.0 流程 实现安全的API认证
  3. Google APIs（谷歌应用程序编程接口） 与People API协作
  4. TypeScript - 构建类型安全的MCP服务器
  5. 实际应用 - 解决实际的生产力问题

非常适合：

  • AI/ML工程师学习MCP（机器学习竞赛平台/模型竞赛平台等，具体含义根据上下文确定）
  • 希望扩展Claude功能的开发者
  • 任何正在构建自定义AI集成的人
  • 人工智能工具开发培训课程

安全与隐私

  • OAuth 2.0 - 行业标准认证
  • 令牌存储 - 安全的本地令牌管理
  • 不收集数据 - 所有数据仅在您与谷歌之间共享
  • 最小作用域 - 仅请求必要的权限
  • 开源 - 自己审核代码

做出贡献

欢迎投稿！请阅读我们的 贡献指南 首先。

许可证

MIT 许可证 - 详见 许可证 文件中有详细信息。

致谢

作者

克里斯·斯皮里托

准备好开始了吗？ 前往 设置指南 开始！

相关 MCP