用途:统一管理 Google Workspace 的 12 项服务,包括 Gmail、Drive、Calendar、Docs、Sheets、Slides、Forms、Tasks、Contacts、Chat、Apps Script 和 Custom Search。
主要能力:Gmail 支持搜索、读取邮件与会话、发送/草拟邮件、下载附件、管理标签与过滤器;Drive 支持搜索、读取、创建、复制、更新、共享与权限管理;Calendar 支持列出日历、获取事件、增删改事件与查询空闲;Docs 支持读取、创建、修改文本与样式、插入元素/图片/表格、查找替换、导出 PDF 与评论;Sheets 支持读写单元格、格式化、条件格式、创建表格与命名范围;Slides、Forms、Tasks、Contacts、Chat 与 Apps Script 也提供对应的读取、创建、更新、删除等工具。
使用方式:优先使用 MCP 工具,工具名可加服务器前缀,如 google-workspace:search_gmail_messages。无 MCP 时用 CLI:uvx workspace-mcp --cli <tool_name> --args '{"user_google_email": "USER_EMAIL", ...}'。首次使用需在 Google Cloud Console 创建 OAuth 2.0 桌面客户端并启用所需 API,将 Client ID 与 Secret 写入 ~/.claude/settings.local.json 的 env 块,再通过 start_google_auth 或首次调用工具完成 OAuth。凭据缓存于 ~/.google_workspace_mcp/credentials。
限制:调用前应查阅对应参考文件确认参数名与类型,不要自造参数;CLI 模式可用 uvx workspace-mcp --cli <tool> --help 查看帮助。start_google_auth 仅适用于旧版 OAuth 2.0,启用 OAuth 2.1 时不可用。资料未提供收费、价格、平台支持范围与效果保证等信息。