Agent-Skills.md

Agent Skills: Google Workspace

Use when working with André's self-hosted Google Workspace MCP (the `google-workspace` plugin) — driving Calendar, Gmail, Drive, Docs, Sheets, Slides, Forms, Tasks, Chat, or Contacts via the `mcp__plugin_google-workspace_workspace__*` tools, OR setting up / troubleshooting its OAuth (first-run consent, 7-day test-mode re-auth, credential storage). Covers the account-isolation rule (never use the `mcp__claude_ai_*` Google connectors — different account).

UncategorizedID: andredezzy/maccing/google-workspace

Repository

andredezzy/maccing
andredezzyLicense: MIT
3

Install this agent skill to your local

pnpm dlx add-skill https://github.com/andredezzy/maccing/tree/HEAD/skills/google-workspace

Skill Files

Browse the full folder contents for google-workspace.

Download Skill

Loading file tree…

skills/google-workspace/SKILL.md

Skill Metadata

Name
google-workspace
Description
Use when working with the bundled self-hosted Google Workspace MCP server — driving Calendar, Gmail, Drive, Docs, Sheets, Slides, Forms, Tasks, Chat, or Contacts through it, OR setting up / troubleshooting its OAuth (first-run consent, 7-day test-mode re-auth, credential storage). Covers the account-isolation rule (never the Google connectors your host ships — they authenticate a different account).

Google Workspace

Self-hosted Google Workspace MCP server, built on workspace-mcp==1.21.2 (PyPI package, taylorwilsdon/google_workspace_mcp). Runs as a per-session stdio process — no daemon, no daily re-authorization. Supports Calendar, Gmail, Drive, Docs, Sheets, Slides, Forms, Tasks, Chat, and Contacts.

Account-isolation rule — the single most important rule

Always use this plugin's workspace server; NEVER a Google connector shipped by your host (mcp__claude_ai_Google_Calendar__*, mcp__claude_ai_Gmail__*, mcp__claude_ai_Google_Drive__* and the like) — those authenticate a different account. Tool-name prefixes differ per host, so match the server, not a fixed prefix. The account this server acts as is whatever USER_GOOGLE_EMAIL is set to.

References — load on demand

| Task | Reference | |---|---| | Google Cloud setup, enabling APIs, OAuth client, publishing consent screen, secrets, tool tiers | references/setup.md | | First-run browser flow, credential storage, no-daily-reauth rationale, reset procedure | references/auth-and-credentials.md | | Tool inventory by service, common workflows, parameter gotchas, user defaults | references/tools.md |

Google Workspace Skill | Agent Skills