作者 aaronsb · aaronsb/google-workspace-mcp
一个 MCP 中的 Gmail、Calendar、Drive 和多账户管理，基于 Google 官方 Workspace CLI — 287 个操作覆盖 15+ 个服务。
aaronsb/google-workspace-mcp 提供 5 个聚合工具（manage_email、manage_calendar、manage_drive、manage_accounts、queue_operations），共覆盖 Google Workspace 287+ 个操作。基于 Google 官方 gws CLI 和 manifest-driven 工厂构建 — 与官方相近但非首方产品。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"google-workspace-2": {
"command": "npx",
"args": [
"-y",
"google-workspace-mcp"
],
"_inferred": true
}
}
}打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。
{
"mcpServers": {
"google-workspace-2": {
"command": "npx",
"args": [
"-y",
"google-workspace-mcp"
],
"_inferred": true
}
}
}Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。
{
"mcpServers": {
"google-workspace-2": {
"command": "npx",
"args": [
"-y",
"google-workspace-mcp"
],
"_inferred": true
}
}
}点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。
{
"mcpServers": {
"google-workspace-2": {
"command": "npx",
"args": [
"-y",
"google-workspace-mcp"
],
"_inferred": true
}
}
}格式与 Claude Desktop 相同。重启 Windsurf 生效。
{
"mcpServers": [
{
"name": "google-workspace-2",
"command": "npx",
"args": [
"-y",
"google-workspace-mcp"
]
}
]
}Continue 使用服务器对象数组，而非映射。
{
"context_servers": {
"google-workspace-2": {
"command": {
"path": "npx",
"args": [
"-y",
"google-workspace-mcp"
]
}
}
}
}加入 context_servers。Zed 保存后热重载。
claude mcp add google-workspace-2 -- npx -y google-workspace-mcp一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。
何时使用： 早上的收件箱。200 条未读。你想知道今天需要回复什么。
结果： 5 分钟完成 30 分钟的收件箱整理。
何时使用： 你需要下周 45 分钟，适合跨时区的 5 个人。
结果： 会议已安排，无需 Doodle 舞蹈。
何时使用： 有人广泛分享了一个敏感文件夹。你想准确了解谁有访问权限。
结果： Drive 安全态势一次性改进。
每周将 Google Docs 镜像到 Notion
| 工具 | 输入参数 | 何时调用 | 成本 |
|---|---|---|---|
| manage_email | action: 'search'|'read'|'send'|'reply'|'label'|..., ... | 任何 Gmail 操作 | 1 Gmail API call |
| manage_calendar | action: 'list'|'create'|'update'|'delete'|'freebusy'|..., ... | 任何 Calendar 操作 | 1 Calendar API call |
| manage_drive | action: 'search'|'upload'|'download'|'share'|'export'|..., ... | 任何 Drive 操作 | 1 Drive API call |
| manage_accounts | action: 'add'|'remove'|'switch'|'list' | 多账户切换 | free |
| queue_operations | steps[] | 链接相互依赖的操作（例如创建文档、共享它） | sum of steps |
Gmail.readonly + Calendar + Drive — 只授予你使用的权限不要将 Gmail.modify 授予也可以读取外部 URL 的无监督代理send 是不可撤销的 — 总是先暂存为草稿进行人工审查。OAuth 期间 invalid_grant客户端 ID / 重定向 URI 不匹配。确认在 GCP 中注册的重定向 URI 与 MCP 使用的 URI 相匹配。
配额已超出退避 + 批处理。Gmail 发送有每日限制；Drive 有按用户/按秒的限制。
Google Cloud Console > APIs > Quotas令牌尽管刷新但已过期刷新令牌已撤销 — 重新认证。账户密码更改或触发安全事件时常见。
| 替代方案 | 何时用它替代 | 权衡 |
|---|---|---|
| 官方 Google Workspace MCP（如果发布） | Google 发布官方 MCP | 会更具权威性；目前这是最强的社区选项 |
| Zapier/Composio 托管的 Google Workspace 工具 | 你想要托管 + 无需 OAuth 设置 | 中间件费用；控制力更少 |