Google Calendar MCP Server: Setup Guide, Use Cases & Limitations

What Is Google Calendar MCP Server?

Google Calendar MCP Server connects Claude to your Google Calendar, enabling read and write access to calendar data through the Model Context Protocol. It is maintained by the community under the v-3 GitHub organization.

Quick Facts

What You Can Do With It

• Event creation: Ask Claude to create calendar events with titles, times, and attendees directly in Google Calendar.
• Schedule reading: Retrieve upcoming events from your calendar so Claude can reason about your availability.
• Meeting scheduling: Find open slots and schedule meetings without leaving your Claude Desktop session.
• Calendar analysis: Query event data across a date range to summarize workload, identify conflicts, or review meeting patterns.

How to Set It Up

Step 1 — Google OAuth credentials

Before running the server, you need a Google Cloud project with the Calendar API enabled and OAuth 2.0 credentials configured. Generate a credentials.json file from the Google Cloud Console and note your CLIENT_ID, CLIENT_SECRET, and REDIRECT_URI.

Step 2 — Add to Claude Desktop config

Locate your Claude Desktop configuration file:
– macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
– Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following block under mcpServers:

“`json
{
“mcpServers”: {
“google-calendar”: {
“command”: “npx”,
“args”: [“@modelcontextprotocol/server-google-calendar”],
“env”: {
“GOOGLE_CLIENT_ID”: “your-client-id”,
“GOOGLE_CLIENT_SECRET”: “your-client-secret”,
“GOOGLE_REDIRECT_URI”: “your-redirect-uri”
}
}
}
}
Step 3 — Authorize

On first run, the server will initiate an OAuth flow. Follow the browser prompt to grant calendar access. A token file will be stored locally for subsequent sessions.

Step 4 — Restart Claude Desktop

Fully quit and relaunch Claude Desktop to load the new server configuration.

Works Best With

This server is verified compatible with Claude Desktop. It is not currently listed as compatible with Claude Code CLI or other MCP clients. If you are running a non-Desktop Claude environment, check the GitHub repository for any community-reported compatibility notes before attempting integration.

Known Limitations

• OAuth setup is required — this server does not support API key authentication. You must complete the Google Cloud OAuth configuration before the server will function.
• Token storage is local — the OAuth refresh token is stored on disk; if it is deleted or expires, you will need to reauthorize.
• Scope is limited to Google Calendar — it does not interact with Google Meet links, Google Tasks, or other Workspace services.
• Rate limits apply — Google Calendar API enforces per-user quotas. Heavy automation (bulk event reads or creation) may hit limits. Review Google’s Calendar API quota documentation for current thresholds.
• Single account only — multi-account calendar access is not documented as a supported feature.

Community Resources

• GitHub Repository — primary source for setup instructions, open issues, and pull requests
• GitHub Issues — report bugs or check known problems before troubleshooting locally
• MCP Discord (Anthropic) — search #mcp channels for community discussion on calendar server configurations
• r/ClaudeAI on Reddit — community threads occasionally cover MCP server setup and Google Calendar integration patterns