How do I install the Google Workspace Auth skill?

Run npx skillmds@latest add bobmatnyc/google-workspace-auth in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Google Workspace Auth safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Google Workspace Auth?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Google Workspace Auth free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Google Workspace Auth?

bobmatnyc (@bobmatnyc) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Google Workspace Auth by bobmatnyc — Agent Skill

Name: Google Workspace Auth
Rating: 4.5 (4 reviews)
Author: bobmatnyc

File contents

Google Workspace Authentication

Re-authenticate or manage Google Workspace MCP OAuth tokens during a Claude Code session.

Quick Commands

Check Token Status

claude-mpm oauth status google-workspace-mcp

Refresh Existing Token

claude-mpm oauth refresh google-workspace-mcp

Full Re-Authentication

# Opens browser for full OAuth flow
claude-mpm oauth setup google-workspace-mcp --no-launch

# If credentials need to be re-entered
claude-mpm oauth setup google-workspace-mcp --force --no-launch

Revoke Tokens (Logout)

claude-mpm oauth revoke google-workspace-mcp

Prerequisites

Google OAuth credentials must be configured in one of:

.env.local (highest priority)
.env
Environment variables

# Required environment variables
GOOGLE_OAUTH_CLIENT_ID="your-client-id.apps.googleusercontent.com"
GOOGLE_OAUTH_CLIENT_SECRET="your-client-secret"

Get credentials from: https://console.cloud.google.com/apis/credentials

OAuth Callback Configuration

The OAuth callback server listens on http://127.0.0.1:8789/callback

Ensure this redirect URI is configured in your Google Cloud Console OAuth client.

Troubleshooting

Token Expired

# Try refresh first (faster, doesn't need browser)
claude-mpm oauth refresh google-workspace-mcp

# If refresh fails, do full re-auth
claude-mpm oauth setup google-workspace-mcp --no-launch

Credentials Not Found

# Force credential prompt
claude-mpm oauth setup google-workspace-mcp --force --no-launch

Check Available Services

claude-mpm oauth list

Available Google Workspace MCP Tools (34 total)

After authentication, these tools become available:

Gmail (5 tools): search_gmail_messages, get_gmail_message_content, send_email, create_draft, reply_to_email

Calendar (6 tools): list_calendars, get_events, create_event, update_event, delete_event

Drive (7 tools): search_drive_files, get_drive_file_content, list_document_comments, create_drive_folder, upload_drive_file, delete_drive_file, move_drive_file

Docs (4 tools): create_document, append_to_document, get_document, upload_markdown_as_doc

Tasks (12 tools): list_task_lists, get_task_list, create_task_list, update_task_list, delete_task_list, list_tasks, get_task, search_tasks, create_task, update_task, complete_task, delete_task, move_task

---name: google-workspace-authdescription: Re-authenticate Google Workspace MCP in-flight - refresh tokens, setup OAuth, check statuslicense: MIT---# Google Workspace AuthenticationRe-authenticate or manage Google Workspace MCP OAuth tokens during a Claude Code session.## Quick Commands### Check Token Status```bashclaude-mpm oauth status google-workspace-mcp```### Refresh Existing Token```bashclaude-mpm oauth refresh google-workspace-mcp```### Full Re-Authentication```bash# Opens browser for full OAuth flowclaude-mpm oauth setup google-workspace-mcp --no-launch# If credentials need to be re-enteredclaude-mpm oauth setup google-workspace-mcp --force --no-launch```### Revoke Tokens (Logout)```bashclaude-mpm oauth revoke google-workspace-mcp```## PrerequisitesGoogle OAuth credentials must be configured in one of:1. `.env.local` (highest priority)2. `.env`3. Environment variables```bash# Required environment variablesGOOGLE_OAUTH_CLIENT_ID="your-client-id.apps.googleusercontent.com"GOOGLE_OAUTH_CLIENT_SECRET="your-client-secret"```Get credentials from: https://console.cloud.google.com/apis/credentials## OAuth Callback ConfigurationThe OAuth callback server listens on `http://127.0.0.1:8789/callback`Ensure this redirect URI is configured in your Google Cloud Console OAuth client.## Troubleshooting### Token Expired```bash# Try refresh first (faster, doesn't need browser)claude-mpm oauth refresh google-workspace-mcp# If refresh fails, do full re-authclaude-mpm oauth setup google-workspace-mcp --no-launch```### Credentials Not Found```bash# Force credential promptclaude-mpm oauth setup google-workspace-mcp --force --no-launch```### Check Available Services```bashclaude-mpm oauth list```## Available Google Workspace MCP Tools (34 total)After authentication, these tools become available:**Gmail (5 tools)**: search_gmail_messages, get_gmail_message_content, send_email, create_draft, reply_to_email**Calendar (6 tools)**: list_calendars, get_events, create_event, update_event, delete_event**Drive (7 tools)**: search_drive_files, get_drive_file_content, list_document_comments, create_drive_folder, upload_drive_file, delete_drive_file, move_drive_file**Docs (4 tools)**: create_document, append_to_document, get_document, upload_markdown_as_doc**Tasks (12 tools)**: list_task_lists, get_task_list, create_task_list, update_task_list, delete_task_list, list_tasks, get_task, search_tasks, create_task, update_task, complete_task, delete_task, move_task

Frequently asked questions

Google Workspace Auth