Multi-account MCP for Gmail, Calendar, Drive, Docs, and Sheets — 61 tools, token

google-workspace-mcp

支持多账户、节省令牌的 MCP，适用于 Gmail + Calendar + Drive + Docs + Sheets。 之所以开发它，是因为官方 Claude 连接器只支持一个账户，而且默认会返回完整的 邮件和文件正文。

通过与 Claude 对话来设置

将此仓库的链接粘贴到 Claude Code 中，并告诉它你想连接电子邮件。Claude Code 会处理终端操作，需要使用网页浏览器的步骤则交由 Claude in Chrome 完成。GUIDED-SETUP.md 提供了这一流程的分步说明，包括具体的浏览器操作。

开发初衷

• 多账户：通过 OAuth 授权多个邮箱（工作、个人、联合创始人）。每个 工具都接受一个 account 邮箱地址；别名通过 Send-As 身份处理。
• 节省令牌：搜索和列表操作返回精简的数据结构（邮件为 {id, from, subject, snippet, ...}，Drive 为 {id, name, mime, modified, size, ...}）。 正文和文件内容需主动选择获取。
• 基于密钥环：刷新令牌存储在操作系统的凭据库中——macOS 上为 Keychain， Windows 上为 Credential Manager，Linux 上为 Secret Service——而不是明文文件中。保险库中没有令牌，任何仓库中也没有令牌。
• 支持 macOS、Windows 和 Linux：每个平台各有一个安装程序，使用同一个连接器。

工具（v2，63 个工具）

账户管理（3）

• gws_account_add — 浏览器 OAuth 流程，用于添加经过授权的新邮箱
• gws_account_list — 列出已授权账户和默认账户
• gws_account_remove — 移除本地凭据（不会撤销 Google 端的授权）

Gmail（12）

• gmail_search — 使用 Gmail 运算符搜索。返回精简结果。
• gmail_read — 阅读单封邮件或完整邮件会话。正文需主动选择获取。
• gmail_send — 发送邮件；可选使用 from_alias 指定 Send-As 身份
• gmail_draft — 创建草稿
• gmail_reply — 回复邮件（保留会话和标头）；可选使用 reply_all
• gmail_labels_list — 列出所有标签
• gmail_label_apply — 批量添加或移除标签
• gmail_archive — 批量归档（移除 INBOX）
• gmail_trash — 批量移至垃圾箱
• gmail_sendas_list — 列出此邮箱的 Send-As 身份
• gmail_attachments_list — 列出邮件的附件（文件名、MIME 类型、大小）
• gmail_attachment_save — 将一个附件下载到本地文件，并返回可直接读取的路径

Calendar（7）

• cal_list_calendars — 列出所有日历
• cal_list_events — 列出即将发生的活动（默认精简；设置 verbose=True 可获取完整信息）
• cal_create_event — 创建活动；可选添加 Google Meet 链接
• cal_update_event — 部分更新字段
• cal_delete_event — 删除活动
• cal_freebusy — 检查忙碌时段以便安排日程
• cal_respond — 接受、拒绝或暂定

Drive（18）

• drive_search — 自由文本或原始 Drive q 语法。仅返回元数据。
• drive_read_file — 默认返回元数据；设置 include_content=True 可获取正文
• drive_list_folder — 列出文件夹的直接子项（My Drive 使用 'root'）
• drive_create_folder — 在可选的父文件夹下创建文件夹
• drive_upload — 上传本地文件，可选 convert_to_google
• drive_move — 更改父文件夹
• drive_rename — 重命名文件或文件夹
• drive_share — 按电子邮件地址授予读取者、评论者、编写者等权限
• drive_trash — 软删除（可恢复）
• drive_untrash — 从回收站恢复
• drive_permission_list — 列出有权访问文件的所有人
• drive_permission_update — 更改被授权者的角色
• drive_permission_delete — 撤销权限
• drive_shared_drives_list — 列出此账号可访问的共享云端硬盘
• drive_comments_list — 列出任何 Drive 文件（Doc/Sheet/Slide/上传文件）上的评论
• drive_comment_add — 添加评论，可选锚点
• drive_comment_reply — 回复评论
• drive_comment_resolve — 将评论标记为已解决

Docs（9）

• docs_create — 新建 Doc，可选初始正文和父文件夹
• docs_read — 默认返回纯文本；设置 structured=True 可获取完整的 Docs API 树
• docs_append — 在正文末尾追加文本
• docs_insert_at — 在指定索引处插入文本
• docs_replace_text — 查找并替换，返回替换次数
• docs_export — 导出为 markdown / pdf / docx / rtf / plain
• docs_suggestions_list — 列出待处理的修订建议
• docs_suggestions_accept_all — 接受所有建议（重写 Doc）
• docs_suggestions_reject_all — 拒绝所有建议（重写 Doc）

Sheets（14）

• sheets_create — 新建工作簿，可选父文件夹
• sheets_list_sheets — 列出工作表标签及行列数
• sheets_add_sheet — 向现有工作簿添加新标签
• sheets_read_range — 读取 A1 范围。支持 FORMULA / UNFORMATTED_VALUE 选项。
• sheets_write_range — 覆盖指定范围。USER_ENTERED 会解析公式。
• sheets_append — 在现有数据下方追加行
• sheets_clear_range — 清除值（保留格式）
• sheets_batch_read — 在一次 API 调用中读取多个范围
• sheets_batch_write — 在一次 API 调用中写入多个范围
• sheets_named_ranges_list — 列出工作簿中的命名范围
• sheets_named_range_add — 创建命名范围
• sheets_named_range_delete — 删除命名范围
• sheets_conditional_format_add — 添加条件格式规则
• sheets_data_validation_add — 设置下拉选项 / 数字 / 电子邮件 / URL 验证

安装

最快方式——运行一个脚本，无需手动配置。

macOS 和 Linux：

git clone https://github.com/adelaidasofia/google-workspace-mcp.git
bash google-workspace-mcp/install.sh

Windows（PowerShell）：

git clone https://github.com/adelaidasofia/google-workspace-mcp.git
powershell -ExecutionPolicy Bypass -File .\google-workspace-mcp\install.ps1

安装程序会创建隔离的 venv、安装依赖、获取你的 Google OAuth 客户端（可通过交互方式输入，或通过环境变量 GWS_CLIENT_ID / GWS_CLIENT_SECRET 提供），并将服务注册到 Claude Code。可以安全地重复运行。你仍需先准备一个 Google OAuth 客户端—— 参见 SETUP.md，了解约 45 分钟的一次性 GCP 设置。然后在 Claude Code 中运行 gws_account_add，授权你的第一个邮箱。

两种方式都需要 Python 3.10 或更高版本，并会自动查找你已有的 Python。

• macOS / Linux 会先尝试 python3，再依次尝试 python3.14 到 python3.10，因此即使 python3 指向 macOS 较旧的系统版本，Homebrew 安装的 Python 也能被找到。
• Windows 会先尝试 py -3（Python 启动器），再尝试 python、 python3 和带版本号的名称。每个候选项都必须能够运行并报告自己的版本，才会被采用；这样可以避免选中 %LOCALAPPDATA%\Microsoft\WindowsApps 中的 Microsoft Store 占位程序：它是 PATH 上真正存在的 python.exe，但只会打开 Store。

如果你的 Python 位于搜索时无法自动找到的位置（pyenv、conda、私有前缀），请指定它：

GWS_PYTHON=/full/path/to/python3 bash google-workspace-mcp/install.sh

$env:GWS_PYTHON = 'C:\full\path\to\python.exe'
powershell -ExecutionPolicy Bypass -File .\google-workspace-mcp\install.ps1

/plugin marketplace add adelaidasofia/google-workspace-mcp
/plugin install google-workspace-mcp@google-workspace-mcp

pip3 install --break-system-packages -r requirements.txt

"google-workspace": {
  "type": "stdio",
  "command": "python3",
  "args": ["/path/to/google-workspace-mcp/server.py"]
}

"google-workspace": {
  "type": "stdio",
  "command": "C:\\Users\\you\\google-workspace-mcp\\.venv\\Scripts\\python.exe",
  "args": ["C:\\Users\\you\\google-workspace-mcp\\server.py"]
}

从 v1 升级到 v2

v2 新增了 Drive + Docs + Sheets 权限范围。每个已授权账户都必须重新进行一次 OAuth 授权，以便 Google 授予新的权限范围。请参见 SETUP.md 第 6b 步。

路线图

• v3：Gmail 过滤器、休假自动回复、推送通知（Gmail Watch）、 Calendar ACL/委派、Slides、Forms、Tasks
• v4：跨服务批量请求、Drive 修订版本

相关 MCP

同一作者、相同架构模式（FastMCP、在适用时写入前先草拟并确认、自动导出到 vault、MIT）：

• slack-mcp — 多工作区 Slack
• imessage-mcp — macOS iMessage
• whatsapp-mcp — 通过 whatsmeow 使用 WhatsApp
• apollo-mcp — Apollo.io CRM + 序列
• substack-mcp — Substack 写作 + 分析
• luma-mcp — lu.ma 活动
• parse-mcp — markitdown / Docling / LlamaParse 路由器
• rescuetime-mcp — RescueTime 效率数据
• graph-query-mcp — vault 知识图谱查询
• graph-autotagger-mcp — 根据图谱提供 wikilink 建议
• investor-relations-mcp — 种子轮融资流程跟踪器
• vault-sync-mcp — 双向 vault 同步

遥测

此插件会在某台机器上的 Claude Code 会话中首次加载时，向 myceliumai.co 发送一次匿名安装信号。

发送内容：

• 插件名称（例如 slack-mcp）
• 插件版本（例如 0.1.0）

不会发送的内容：

• 不会发送用户标识符、姓名、电子邮件、令牌或 API 密钥
• 不会发送文件路径、消息内容或任何工作相关内容
• 去重处理后不会存储 IP 地址

原因： 帮助维护者了解用户实际安装了哪些插件，以便将精力投入到有人使用的插件上。

选择退出： 在启动 Claude Code 前设置环境变量 MYCELIUM_NO_PING=1。此钩子将完全跳过网络调用。已发送过信号的安装会在 ~/.mycelium/onboarded-<plugin> 留下一个标记文件——如果想重置状态，请将其删除。

许可证

MIT

由 Mycelium AI 构建。完整安装版或团队版请访问 diazroa.com。