authenticate | google-workspace-mcp | ClaudePluginHub

Skill

Community

authenticate

From google-workspace-mcp

3

Description

Authenticate Gmail and Google Calendar MCP servers. Use after first install, after codespace rebuild, or when MCP authentication fails. Runs OAuth flow for both Gmail and Calendar services.

AI Summary

Authenticates Gmail and Google Calendar MCP servers via OAuth 2.0 when setup or reconnection is required.

Install

1

Add the repository(one-time)

$

/plugin marketplace add reggiechan74/cc-plugins

2

Install the plugin

$

/plugin install google-workspace-mcp@cc-plugins

Tool Access

This skill inherits all available tools. When active, it can use any tool Claude has access to.

Skill Content

Google Workspace Authentication

Authenticate the Gmail and Google Calendar MCP servers via OAuth 2.0.

Prerequisites

A Google Cloud Platform project with a Desktop-type OAuth 2.0 Client ID
Download the OAuth JSON and place it in BOTH locations:
- ~/.gmail-mcp/gcp-oauth.keys.json
- ~/.calendar-mcp/gcp-oauth.keys.json
Enable these APIs in the GCP project:
- Gmail API
- Google Calendar API
- People API (for contact lookup)

Procedure

Verify OAuth keys exist:

ls ~/.gmail-mcp/gcp-oauth.keys.json ~/.calendar-mcp/gcp-oauth.keys.json

Create config directories if missing:
```
mkdir -p ~/.gmail-mcp ~/.calendar-mcp
```
Authenticate Gmail server (opens browser for OAuth consent):
```
node ${CLAUDE_PLUGIN_ROOT}/servers/gmail/index.js auth
```

Authenticate Calendar server:

node ${CLAUDE_PLUGIN_ROOT}/servers/calendar/index.js auth

Verify credentials were created:

ls ~/.gmail-mcp/credentials.json ~/.calendar-mcp/credentials.json

Test connectivity by running /mcp to reconnect both servers.
Report success/failure to user.

Troubleshooting

Port 3000 conflict: lsof -ti:3000 | xargs kill -9 then retry
Browser doesn't open: Copy the auth URL from terminal output manually
People API error: Ensure People API is enabled in GCP console
Token expired: Re-run this authentication flow. Tokens auto-refresh during normal use but may expire after prolonged inactivity.

Links

GitHub Stats

0 forks

Updated 16 days ago

Actions

Similar Skills

REST API design patterns including resource naming, status codes, pagination, filtering, error responses, versioning, and rate limiting for production APIs.

everything-claude-code

56.9k

article-writing

Write articles, guides, blog posts, tutorials, newsletter issues, and other long-form content in a distinctive voice derived from supplied examples or brand guidance. Use when the user wants polished written content longer than a paragraph, especially when voice consistency, structure, and credibility matter.

everything-claude-code

56.9k

backend-patterns

Backend architecture patterns, API design, database optimization, and server-side best practices for Node.js, Express, and Next.js API routes.

everything-claude-code

56.9k