项目概述

欢迎使用MCP Google Contacts Server！这是一个强大的工具，用于与Google Contacts API交互，管理您的联系人和Google Workspace目录。该服务器允许您执行各种操作，如创建、更新、删除联系人，以及搜索其他 contacts。

功能介绍

• 列出所有联系人：获取您所有Google Contacts或按名称过滤
• 获取特定联系人信息：通过资源名称或电子邮件地址检索详细信息
• 创建新联系人：添加新的联系人信息
• 更新现有联系人：修改现有联系人的信息
• 删除联系人：从您的Google Contacts中删除指定的联系人
• 搜索 contacts：通过姓名、电子邮件或电话号码搜索特定联系人
• 列出Google Workspace 用户：获取您组织目录中的所有用户
• 搜索目录成员：执行目标搜索以查找特定的目录成员
• 获取其他 contacts：检索您互动过但未添加到 Contacts 中的人

详细工具描述

list_contacts

列出所有您的 Google 联系人，或按名称过滤。

参数：

• name_filter（可选）：用于按名称筛选联系人的字符串
• max_results（可选）：要返回的最大联系人数，默认为100

示例：

list_contacts(name_filter="John", max_results=10)

get_contact

检索特定联系人详细信息。

参数：

• identifier：资源名称（people/*）或电子邮件地址

示例：

get_contact("john.doe@example.com")
# 或者
get_contact("people/c12345678901234567")

create_contact

创建新的 Google 联系人。

参数：

• given_name：联系人的姓
• family_name（可选）：联系人的名
• email（可选）：电子邮件地址
• phone（可选）：电话号码

示例：

create_contact(given_name="Jane", family_name="Smith", email="jane.smith@example.com", phone="+1-555-123-4567")

update_contact

更新现有联系人信息。

参数：

• resource_name：联系人资源名称（people/*）
• given_name（可选）：更新的姓
• family_name（可选）：更新的名
• email（可选）：更新的电子邮件地址
• phone（可选）：更新的电话号码

示例：

update_contact(resource_name="people/c12345678901234567", email="new.email@example.com")

delete_contact

删除指定联系人。

参数：

• resource_name：要删除的联系人资源名称（people/*）

示例：

delete_contact(resource_name="people/c12345678901234567")

search_contacts

按姓名、电子邮件或电话号码搜索 contacts。

参数：

• query：用于搜索的查询词
• max_results（可选）：要返回的最大结果数，默认为10

示例：

search_contacts(query="john", max_results=5)

list_workspace_users

列出您组织目录中的所有 Google Workspace 用户。

参数：

• query（可选）：用于查找特定用户的查询词
• max_results（可选）：要返回的最大结果数，默认为50

示例：

list_workspace_users(query="engineering", max_results=25)

search_directory

执行目标搜索以查找特定的目录成员。

参数：

• query：用于搜索的查询词
• max_results（可选）：要返回的最大结果数，默认为10

示例：

search_directory(query="Marketing", max_results=20)

get_other_contacts

检索您互动过但未添加到 Contacts 中的人。

参数：

无

示例：

get_other_contacts()

权限说明

要使用此服务器，您需要具备以下权限：

• 读取和写入 Google 联系人
• 管理 Google Workspace 目录

请确保您的 API 密钥具有适当的权限。

故障排除指南

常见问题解答

1. 如何获取我的API密钥？

   • 您可以在Google Cloud Console中找到并生成新的API密钥。

2. 我收到权限错误怎么办？

   • 确保您的 API 密钥具有所需的权限。您可能需要启用 Google 联系人 API 和 Google Workspace 目录 API。

3. 无法连接到服务器？

   • 检查您的网络连接，确保没有防火墙阻止与 Google 服务的通信。

4. 如何解决404错误？

   • 确保您提供的资源名称或电子邮件地址是正确的，并且格式正确。

贡献和许可

此项目遵循 MIT 许可证。我们欢迎社区贡献，但请确保遵守代码规范并提供详细的提交信息。

如需贡献，请访问我们的 GitHub 仓库：MCP Google Contacts Server

相关链接

• Google 联系人 API 文档
• Google Workspace 目录 API 文档