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

This asset can be read and installed directly by agents

TokRepo exposes a universal CLI command, install contract, metadata JSON, adapter-aware plan, and raw content links so agents can judge fit, risk, and next actions.

Stage only · 17/100Stage only
Agent surface
Any MCP/CLI agent
Kind
Mcp Config
Install
Stage only
Trust
Trust: Established
Entrypoint
Asset
Universal CLI install command
npx tokrepo install 8fc8cc2f-1024-4c2b-9aef-fd3b661c0019
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