The problem
How it works
The README walks through creating an OAuth client in your own Google Cloud project, enabling the APIs you need, and launching the server with uvx, either loading only some services (for example Gmail, Drive and Calendar) or a smaller core tool tier. It then connects to an MCP client; the project links setup guides for Claude Desktop and web connectors and ships a CLI for Claude Code and Codex. Calendar tools cover events, free and busy time, Out of Office and Focus Time; Gmail tools cover search, drafts, labels and filters.
Results and limitations
The maintainer reports more than 120 tools across twelve Workspace services, multi-user OAuth 2.1, a read-only mode and per-service permissions; no usage outcomes are published.
Before you try it
You control the scopes because the OAuth client is yours; start with read-only mode or the core tier so the assistant can read your calendar before it can change it. The server only calls Google’s APIs and has no telemetry unless you configure tracing. Email content can carry prompt injection, so confirm any send or delete. MIT licensed. Results depend on your setup and were not independently reproduced by Top 200 Repos.
Tools and repositories
No ranked repository is involved. This use case still stands on its own source.
- Tools
- Google Workspace MCP · Claude Desktop · Google Cloud OAuth client · uv
- Prerequisites
- A Google account, a Google Cloud project with the needed APIs enabled and an MCP client such as Claude Desktop or Claude Code.
Try it yourself: Plan my week from the calendar
Fill the fields to adapt the prompt. Empty fields stay as visible [placeholders].
Using the Google Calendar tools, read my events from [Start date] to [End date] and list them by day. Point out double bookings, days with no break longer than [Shortest acceptable break], and meetings without an agenda in the description. Propose up to three changes, such as a Focus Time block or a meeting to move, and explain each one. Do not create, move, decline or delete anything, and do not email anyone, until I approve each change by number.Run the server in read-only mode for the first sessions; switch on write tools only for the services you need.
Sources
- taylorwilsdon/google_workspace_mcp README (opens in a new tab)
Project documentation · github.com · Undated · Source checked 11 Nov 2026, 10:08 UTC
What this source supports
- MCP server for Gmail, Calendar, Drive, Docs, Sheets and more; 120+ tools
- Your own OAuth client and Google Cloud project; launch with uvx
- Tool tiers, per-service selection, read-only mode and per-service permissions
- Setup guides for Claude Desktop and web connectors; CLI for Claude Code and Codex
- Calls only Google APIs; no telemetry unless configured; MIT licence