# Google Workspace MCP — Gmail/Calendar/Drive for Agents

> Google Workspace MCP exposes Gmail, Calendar, and Drive actions as MCP tools so agents can summarize inboxes and manage schedules with minimal scopes.

## Install

Merge the JSON below into your `.mcp.json`:

## Quick Use

1. Install / run:
   ```bash
   git clone https://github.com/aaronsb/google-workspace-mcp && cd google-workspace-mcp
   ```
2. Start / smoke test:
   ```bash
   sed -n '1,280p' README.md
   ```
3. Verify:
   - Authorize with the minimal scopes, then call one read-only tool (search/list) before enabling send/create actions.

## Intro

Google Workspace MCP exposes Gmail, Calendar, and Drive actions as MCP tools so agents can summarize inboxes and manage schedules with minimal scopes.

- **Best for:** People who want an agent to triage Gmail and manage calendars without relying on brittle browser automation
- **Works with:** An MCP client + Google Workspace OAuth credentials (per repo docs)
- **Setup time:** 25 minutes

## Practical Notes

- Setup time ~25 minutes (OAuth consent + run server + connect client)
- Safety check: keep ‘send/create’ tools behind confirmation and minimal scopes
- GitHub stars + forks (verified): see Source & Thanks

For email and calendars, ‘agent autonomy’ should be staged. Start with summarize/search only, then allow drafting, and only then consider sending. In practice, the best ROI is a reliable inbox digest and an always-correct availability checker.

### FAQ

**Q: Is this safer than giving an agent my email UI?**
A: Yes. Tool scopes and server-side logs are easier to control than UI automation.

**Q: What’s the first workflow to automate?**
A: Daily inbox summary + draft replies (not auto-send) and calendar availability checks.

**Q: How do I avoid spamming people?**
A: Disable send by default, require confirmations, and add per-domain allowlists.

## Source & Thanks

> Source: https://github.com/aaronsb/google-workspace-mcp
> License: MIT
> GitHub stars: 149 · forks: 47

---

<!-- ZH -->

## 快速使用

1. 安装 / 运行：
   ```bash
   git clone https://github.com/aaronsb/google-workspace-mcp && cd google-workspace-mcp
   ```
2. 启动 / 冒烟测试：
   ```bash
   sed -n '1,280p' README.md
   ```
3. 验证：
   - 先用最小 scope 完成授权，再调用一次只读工具（search/list）确认可用，最后再开启发送/创建类动作。

## 简介

Google Workspace MCP 把 Gmail、Calendar、Drive 等能力封装成 MCP 工具，让 agent 能做收件箱总结、日程安排与文件检索，同时通过显式 scope 控制权限并保留审计。

- **适合谁：** 想让 agent 管理 Gmail/日历，但不想依赖脆弱的浏览器自动化的人
- **可搭配：** 支持 MCP 的客户端 + Google Workspace OAuth 凭证（以仓库文档为准）
- **准备时间：** 25 分钟

## 实战建议

- 上手约 25 分钟（OAuth 授权 + 启动 server + 连接客户端）
- 安全验收：发送/创建类工具要二次确认，并始终使用最小 scope
- GitHub stars + forks（已核验）：见「来源与感谢」

邮箱与日历的“自主”必须分阶段：先只读总结/检索，再开放草拟，最后才考虑发送。多数情况下，最有价值的是稳定的 inbox digest 与准确的空闲时间查询。

### FAQ

**比把邮箱 UI 交给 agent 更安全吗？**
A: 通常更安全：工具的 scope 与 server 日志更容易控制，UI 自动化更脆弱。

**最先自动化什么流程？**
A: 每日收件箱总结 + 草拟回复（不要自动发送）+ 查询日程空闲。

**如何避免误发？**
A: 默认关闭发送，所有发送都需确认，并对域名做 allowlist。

## 来源与感谢

> Source: https://github.com/aaronsb/google-workspace-mcp
> License: MIT
> GitHub stars: 149 · forks: 47


---
Source: https://tokrepo.com/en/workflows/google-workspace-mcp-gmail-calendar-drive-for-agents
Author: MCP Hub