Google Workspace (gsuite-sdk)

io.github.PabloAlaniz由 GitHub 账号 PabloAlaniz 发布v0.13.0更新于 Nov 7, 2026

Gmail, Calendar, Drive, Sheets, Tasks and Contacts for agents, with your own Google login

已验证STDIO仅桌面效率与工作流沟通与协作数据与分析

概览

AI 生成的概览

本地 MCP 服务器，让助手使用你自己的 Google Workspace 账号处理 Gmail、日历、云端硬盘、表格、任务和联系人。

可以做什么
  • 查看登录状态与已授权的权限范围
  • 搜索、读取、发送、回复、转发、起草、加标签和移入垃圾箱的 Gmail 邮件
  • 列出、创建和删除日历事件，查询空闲/忙碌时间
  • 搜索、读取、上传和共享云端硬盘文件
  • 读取、追加、更新和 upsert Google 表格行
  • 列出、添加和完成任务，搜索和管理联系人及群组
适用场景
适合希望助手在自己的 Google 账号内整理邮件、安排会议、查看或修改表格与云端硬盘文件、管理任务和联系人的场景，而不是使用共享的服务账号。
运行要求
以 stdio 方式在本机运行，通过 uvx 启动 PyPI 包 gsuite-mcp。需要 Google Cloud 的 OAuth 客户端 JSON 文件，并用 gsuite CLI 完成一次登录以生成 tokens.db；需在 GSUITE_TOKEN_DB_PATH（必填）和 GSUITE_CREDENTIALS_FILE 中填写绝对路径，GSUITE_DEFAULT_TIMEZONE 可选。营销类工具需额外授权并在 Cloud 项目中启用相应 API。
安装前请注意
服务器以你 Google 账号的完整权限操作：工具可以发送、转发、共享、覆盖和删除邮件、文件、事件、表格行和联系人，执行写入操作前应先确认。tokens.db 与 OAuth 客户端文件属于凭据，应妥善保管。重新登录会替换已保存的权限范围，需重新列出所有要用的范围。营销类权限虽为只读，但仍会暴露分析数据。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Google Workspace (gsuite-sdk)，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

gsuite-mcp

An MCP server for Google Workspace: Gmail, Calendar, Drive, Sheets, Tasks and Contacts, built on gsuite-sdk. It runs locally over stdio and uses your own Google login.

Setup

  1. Get an OAuth client file from Google Cloud (guide) and log in once with the gsuite CLI:

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

    The token is saved to tokens.db in the current directory (or GSUITE_TOKEN_DB_PATH).

  2. Add the server to your MCP client, pointing at that token with absolute paths:

    json
    {  "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

Tools

AreaTools
Accountauth_status
Gmailgmail_search, gmail_read, gmail_read_thread, gmail_list_labels, gmail_list_drafts, gmail_send, gmail_reply, gmail_forward, gmail_create_draft, gmail_send_draft, gmail_delete_draft, gmail_modify_labels (archive, read/unread, star, file), gmail_create_label, gmail_trash
Calendarcalendar_list_events, calendar_create_event, calendar_delete_event, calendar_free_busy
Drivedrive_search, drive_read_file, drive_upload, drive_share
Sheetssheets_read, sheets_append, sheets_update, sheets_upsert
Taskstasks_list, tasks_add, tasks_complete
Contactscontacts_search, contacts_get, contacts_list_groups, contacts_group_members, contacts_create_group, contacts_modify_group, contacts_delete_group
Search Console (read-only)searchconsole_list_sites, searchconsole_query, searchconsole_inspect_url, searchconsole_list_sitemaps
Analytics GA4 (read-only)analytics_account_summaries, analytics_list_properties, analytics_run_report, analytics_run_realtime_report
Tag Manager (read-only)tagmanager_list_accounts, tagmanager_list_containers, tagmanager_list_workspaces, tagmanager_list_tags, tagmanager_list_triggers, tagmanager_list_variables, tagmanager_list_versions

Search Console, Analytics and Tag Manager need the opt-in read-only scopes (--scopes ...,marketing) and their APIs enabled in your Cloud project. A login replaces the stored scopes, so keep listing the sets you already use.

Read tools are annotated read-only; tools that send, share, overwrite or delete are marked so clients can ask before running them. Dates are ISO 8601; times without an offset use GSUITE_DEFAULT_TIMEZONE (UTC by default).

The same capabilities are available as an agent skill, a CLI and a REST API: see gsuite-sdk.

License

MIT

来源：packages/mcp/README.md，提交 666ae3c

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

9
  1. v0.13.0最新Nov 7, 2026
  2. v0.10.0Nov 5, 2026
  3. v0.9.0Oct 23, 2026
  4. v0.7.0Oct 22, 2026
  5. v0.6.0Oct 17, 2026
  6. v0.5.2Oct 14, 2026
  7. v0.5.1Oct 14, 2026
  8. v0.5.0Oct 12, 2026
  9. v0.4.0Oct 10, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分