用途：面向智能体调用的 Google Contacts 工具集，封装 Google People API，用于保存、查找、更新、删除个人联系人，管理联系人分组（标签）及成员，设置或移除联系人照片，以及浏览自动保存的“其他联系人”并将其提升为已保存联系人。所有工具共用单一 OAuth 连接，能力受所授予 scope 限制。
主要能力：createContact 创建联系人；getContact 按资源名获取单个联系人；updateContact 更新联系人（发送的数组会整体替换该字段，未发送字段不变）；deleteContact 删除联系人；listContacts 分页列出联系人；searchContacts 按姓名、昵称、邮箱、电话或组织前缀匹配搜索；updateContactPhoto 用 base64 图片设置或替换照片；deleteContactPhoto 移除照片；listContactGroups、getContactGroup、createContactGroup、updateContactGroup、deleteContactGroup 管理分组；modifyContactGroupMembers 增删组成员且不影响其他归属；listOtherContacts、searchOtherContacts、copyOtherContact 处理“其他联系人”。
使用方式：这是 agentskills.io 技能。未安装时先执行 npx skills add zapier/connectors --skill google-contacts，再运行 npm install --omit=dev。运行需 Node.js 22.18+。按运行形态加载对应参考：MCP 客户端用 references/use-as-mcp.md，终端用 references/use-as-cli.md，作为依赖导入用 references/use-as-sdk.md，无工具无终端则用 references/use-as-recipe.md。认证以连接选择器字符串传入，如 zapier:<connection-id>，具体语法随形态而异。脚本返回 { data, meta } 信封，可用 jq 表达式裁剪 data，也可跳过输出校验获取原始结果。
限制：不支持批量/批处理增删改、Google Workspace 目录查询、联系人合并去重；不得用循环模拟批量操作。按姓名写入前应先搜索并核对唯一匹配，多个同名需列出候选并询问。编辑列表字段会整体替换，建议先 getContact 再追加。使用前应加载 references/google-contacts-api-gotchas.md 了解错误码、etag 并发、搜索前缀匹配、写入传播延迟、资源名格式、分组类型、成员上限、其他联系人字段限制与分页。