AI导哈

Google Workspace连接服务

一个连接AI代理与Google Workspace（包括Gmail、Calendar、Drive、Docs、Sheets和Slides）的模型上下文协议（MCP）服务器。

  • by tannht
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 tannht/google-cloud-mcp

使用说明

谷歌云MCP-谷歌工作区MCP服务器（gg MCP）

将AI代理连接到Google Workspace的模型上下文协议（MCP）服务器： Gmail, 日历, 驾驶, 文档, 表格，以及 幻灯片.内置 FastMCP.

# Install and run — that's it
uvx gg-mcp

� 目录

  1. 快速入门（5分钟）
  2. 可用工具
  3. 安装选项
  4. 环境变量
  5. 故障排除
  6. 文档
  7. 发展

🚀 快速入门（5分钟）

步骤1：获取Google OAuth凭据

  1. 首选 Google 云控制台
  2. 创建项目并启用 OAuth 授权界面 （外部类型）
  3. 添加所需的范围（Gmail、驱动器、日历、文档、表格、幻灯片）
  4. 创建 OAuth 2.0桌面应用程序 凭证
  5. 复制 客户端ID 和 客户端密钥

📖 详细指南→

步骤2：安装并运行

export GOOGLE_CLIENT_ID="your-client-id.apps.googleusercontent.com"
export GOOGLE_CLIENT_SECRET="your-client-secret"
uvx gg-mcp

您将看到：

============================================================
🔐 GOOGLE ACCOUNT AUTHENTICATION
📱 Open your browser: http://localhost:3838
============================================================

打开 http://localhost:3838 → “向谷歌授权” → 授予权限✅

步骤3：配置MCP客户端

克劳德桌面 (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "gg-mcp": {
      "command": "uvx",
      "args": ["gg-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

重新启动Claude Desktop，工具即可使用！ 🎉

📖 25+客户端配置→

📋 可用工具（30+）

账户

  • get_account_info -获取经过身份验证的Google帐户的电子邮件

Gmail

  • send_email -发送电子邮件（收件人、主题、正文）
  • create_gmail_label -创建新的Gmail标签
  • list_gmail_labels -列出所有用户创建的标签

谷歌日历

  • list_calendar_events -列出即将发生的事件（max_results，days_back）
  • create_calendar_event -创建事件（摘要、开始时间、结束时间）

Google 云端硬盘

  • list_drive_folders -列出Google Drive中的所有文件夹（根文件夹或特定父文件夹）
  • search_drive -按查询字符串搜索文件

谷歌文件

  • create_document -使用可选文本创建新文档
  • get_document -获取文档的全文内容
  • append_to_document -将文本附加到文档末尾
  • search_documents -在驱动器中搜索文档
  • export_document -导出文档（文本、html、pdf、docx）

谷歌表格

  • create_spreadsheet -创建新的电子表格
  • read_spreadsheet -从某个范围读取数据
  • update_spreadsheet -使用JSON 2D数组更新单元格
  • append_to_spreadsheet -将行追加到电子表格
  • search_spreadsheets -在Drive中搜索电子表格
  • get_spreadsheet_info -获取元数据和维度
  • clear_spreadsheet_range -清除范围内的所有值
  • batch_update_spreadsheet -批量更新多个范围
  • add_sheet -添加新工作表/选项卡
  • export_spreadsheet -导出（csv、xlsx、pdf、tsv）

谷歌幻灯片

  • create_presentation -创建新演示文稿
  • get_presentation -获取幻灯片元数据和内容
  • add_slide -添加带有布局选择的新幻灯片
  • add_text_to_slide -添加文本框以幻灯片
  • search_presentations -搜索演示文稿
  • delete_slide -按索引删除幻灯片
  • export_presentation -导出（pdf、pptx、txt）

🚀 快速入门（5分钟）

步骤1：获取Google OAuth凭据

  1. 首选 Google 云控制台
  2. 创建项目并启用 OAuth 授权界面 （外部类型）
  3. 添加所需的范围（Gmail、驱动器、日历、文档、表格、幻灯片）
  4. 创建 OAuth 2.0桌面应用程序 凭证
  5. 复制 客户端ID 和 客户端密钥

📖 详细指南→

步骤2：安装并运行

export GOOGLE_CLIENT_ID="your-client-id.apps.googleusercontent.com"
export GOOGLE_CLIENT_SECRET="your-client-secret"
uvx gg-mcp

您将看到：

============================================================
🔐 GOOGLE ACCOUNT AUTHENTICATION
📱 Open your browser: http://localhost:3838
============================================================

打开 http://localhost:3838 → “向谷歌授权” → 授予权限✅

步骤3：配置MCP客户端

克劳德桌面 (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "gg-mcp": {
      "command": "uvx",
      "args": ["gg-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

📖 25+客户端配置→

📦 安装选项

选项A:PyPI（推荐）

pip install gg-mcp
export GOOGLE_CLIENT_ID="..."
export GOOGLE_CLIENT_SECRET="..."
gg-mcp

选项B：来源

git clone https://github.com/tannht/google-cloud-mcp.git
cd google-cloud-mcp
uv sync
export GOOGLE_CLIENT_ID="..."
export GOOGLE_CLIENT_SECRET="..."
uv run main.py

选项C:Docker

git clone https://github.com/tannht/google-cloud-mcp.git
cd google-cloud-mcp
docker-compose up -d --build

🔑 环境变量

变量 必填 默认 用途
GOOGLE_CLIENT_ID 是 -- OAuth 2.0客户端ID
GOOGLE_CLIENT_SECRET 是 -- OAuth 2.0客户端密码
GOOGLE_TOKEN_PATH 没有 .token.json 令牌文件路径
GOOGLE_TOKEN_JSON 否 -- 标记为JSON字符串
AUTH_PORT 没有 3838 认证门户端口

❓ 故障排除

问题 解决方案
403: access_denied 将您的电子邮件添加到 测试用户 在OAuth同意屏幕中
401: Invalid credentials 验证GOOGLE_CLIENT_ID和GOOGLE_CLIEN_CRET
Token expired 删除 .token.json 并重新验证
无法访问http://localhost:3838 端口3838正在使用中。尝试 AUTH_PORT=8080
403: API not enabled 在中启用API Google 云控制台

📖 全面故障排除→

📚 文档

🛠️ 发展

git clone https://github.com/tannht/google-cloud-mcp.git
cd google-cloud-mcp
uv sync --group dev
uv run pytest -v  # Run tests

📖 开发人员设置→

📄 许可证

麻省理工学院

👥 贡献者

  • 黄谭 （业主）
  • PubPug助理 （主要开发者）

相关 MCP