Google Workspace (gsuite-sdk)

Name: Google Workspace (gsuite-sdk)
Author: PabloAlaniz

本地服务

pabloalaniz.github.io生产力0今天更新

代码仓库访问官网

关于 Google Workspace (gsuite-sdk)

Google Workspace (gsuite-sdk) 是本地运行的 MCP 服务，供使用个人 Google 登录的 Agent 调用。它提供 Gmail、Calendar、Drive、Sheets、Tasks、Contacts 及可选只读营销服务的工具。

主要功能

01搜索、读取、发送和草拟 Gmail 邮件
02列出并管理 Calendar 事件
03搜索、读取、上传和分享 Drive 文件
04读取和更新 Sheets
05管理 Tasks 并搜索 Contacts
06只读访问 Search Console、GA4 和 Tag Manager

适用场景

01搜索并回复 Gmail 邮件
02创建 Calendar 事件并查看空闲时间
03更新 Sheets 并整理 Drive 文件
04查询只读网站分析数据

MCP 相关

通过 stdio 在本地运行，并向 MCP 客户端提供 Google Workspace 工具。使用个人 Google 登录认证，可按需选择 Tasks、Contacts、Search Console、Analytics 和 Tag Manager 的权限范围。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "pabloalaniz-gsuite-sdk": {
      "command": "uvx",
      "args": [
        "gsuite-mcp"
      ],
      "env": {
        "GSUITE_TOKEN_DB_PATH": "<GSUITE_TOKEN_DB_PATH>",
        "GSUITE_CREDENTIALS_FILE": "<GSUITE_CREDENTIALS_FILE>",
        "GSUITE_DEFAULT_TIMEZONE": "<GSUITE_DEFAULT_TIMEZONE>"
      }
    }
  }
}

启动命令uvx gsuite-mcp

需要配置的环境变量

GSUITE_TOKEN_DB_PATH密钥Absolute path to the tokens.db written by `gsuite auth login`

GSUITE_CREDENTIALS_FILE密钥Absolute path to the Google OAuth client JSON (needed to refresh the login)

GSUITE_DEFAULT_TIMEZONETime zone for dates without an offset, e.g. America/Argentina/Buenos_Aires

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypigsuite-mcp0.9.0stdio

工具

收录的工具列表 · 更新于 5 天前

此工具无需参数。

详细介绍

gsuite-mcp

一个适用于 Google Workspace 的 MCP 服务，支持 Gmail、 Calendar、Drive、Sheets、Tasks 和 Contacts，基于 gsuite-sdk 构建。它通过 stdio 在本地运行，并使用你自己的 Google 登录信息。

设置

从 Google Cloud 获取 OAuth 客户端文件（指南），然后使用 gsuite CLI 登录一次：

pip install "gsuite-sdk[cli]"
gsuite auth login                                   # Gmail, Calendar, Drive, Sheets
gsuite auth login --force --scopes default,tasks,contacts   # + Tasks and Contacts
gsuite auth login --force --scopes default,tasks,contacts,marketing  # + Search Console, GA4, Tag Manager (read-only)

令牌会保存到当前目录中的 tokens.db（或 GSUITE_TOKEN_DB_PATH）。

将该服务添加到 MCP 客户端，并使用绝对路径指向该令牌：

{
  "mcpServers": {
    "gsuite": {
      "command": "uvx",
      "args": ["gsuite-mcp"],
      "env": {
        "GSUITE_TOKEN_DB_PATH": "/Users/you/gsuite/tokens.db",
        "GSUITE_CREDENTIALS_FILE": "/Users/you/gsuite/credentials.json",
        "GSUITE_DEFAULT_TIMEZONE": "America/Argentina/Buenos_Aires"
      }
    }
  }
}

Claude Code：claude mcp add gsuite -e GSUITE_TOKEN_DB_PATH=/Users/you/gsuite/tokens.db -- uvx gsuite-mcp

工具

区域	工具
账号	`auth_status`
Gmail	`gmail_search`、`gmail_read`、`gmail_send`、`gmail_reply`、`gmail_create_draft`
Calendar	`calendar_list_events`、`calendar_create_event`、`calendar_delete_event`、`calendar_free_busy`
Drive	`drive_search`、`drive_read_file`、`drive_upload`、`drive_share`
Sheets	`sheets_read`、`sheets_append`、`sheets_update`、`sheets_upsert`
Tasks	`tasks_list`、`tasks_add`、`tasks_complete`
Contacts	`contacts_search`、`contacts_get`
Search Console（只读）	`searchconsole_list_sites`、`searchconsole_query`、`searchconsole_inspect_url`、`searchconsole_list_sitemaps`
Analytics GA4（只读）	`analytics_account_summaries`、`analytics_list_properties`、`analytics_run_report`、`analytics_run_realtime_report`
Tag Manager（只读）	`tagmanager_list_accounts`、`tagmanager_list_containers`、`tagmanager_list_workspaces`、`tagmanager_list_tags`、`tagmanager_list_triggers`、`tagmanager_list_variables`、`tagmanager_list_versions`