MCP ConfigsMay 12, 2026·2 min read

Workspace MCP — Google Workspace Tools via MCP

Workspace MCP exposes Gmail/Drive/Calendar tools over MCP with uv launch tiers and an HTTP mode designed to work with Claude Code OAuth flows.

Agent ready

Safe staging for this asset

This asset is staged first. The copied prompt tells the agent to inspect the staged files and ask before activating scripts, MCP config, or global config.

Stage only · 17/100Policy: stage
Agent surface
Any MCP/CLI agent
Kind
Mcp Config
Install
Stage only
Trust
Trust: Established
Entrypoint
Asset
Safe staging command
npx -y tokrepo@latest install 8fc8cc2f-1024-4c2b-9aef-fd3b661c0019 --target codex

Stages files first; activation requires review of the staged README and plan.

Intro

Workspace MCP exposes Gmail/Drive/Calendar tools over MCP with uv launch tiers and an HTTP mode designed to work with Claude Code OAuth flows.

  • Best for: agents that need Google Workspace automation with OAuth and fine-grained tool selection
  • Works with: Python + uv/uvx, Google OAuth credentials, MCP clients (HTTP recommended for OAuth)
  • Setup time: 25–60 minutes

Practical Notes

  • Data point: default HTTP endpoint in docs is http://localhost:8000/mcp.
  • Quant: start with --tool-tier core before enabling extended/complete to reduce scope.

Pattern: separate auth setup from tool rollout

With Google OAuth, the most reliable rollout is:

  1. make auth succeed for one user,
  2. run read-only tools,
  3. then enable write scopes.

Hardening tips

  • Prefer HTTP transport for OAuth flows and multi-user setups.
  • Store OAuth client secrets in a secret manager (not .env committed to git).
  • Restrict available tools to the minimum required per workflow.

FAQ

Q: Can it run in stdio mode? A: The README recommends HTTP mode for OAuth 2.1 and multi-user support.

Q: How do I limit permissions? A: Start with a smaller tool tier and enable write tools only when needed.

Q: Does it support VS Code MCP? A: Yes. The README includes a .vscode/mcp.json example and notes about HTTP transport.

🙏

Source & Thanks

Source: https://github.com/taylorwilsdon/google_workspace_mcp > License: MIT > GitHub stars: 2,380 · forks: 724

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets