@cocal/google-calendar-mcp

What it does

Provides Google Calendar integration via MCP, enabling AI assistants to manage events across multiple accounts and calendars. Supports creating, updating, deleting, and searching calendar events; checking availability across calendars; and importing events from images, PDFs, or links. Multi-account support lets you query work and personal calendars simultaneously, and the server detects scheduling conflicts across any combination of calendars.

Who it's for

Developers building AI assistants that need calendar awareness, team leads automating scheduling workflows across multiple Google accounts, and anyone who wants Claude to access and manage their calendar without leaving the chat. Useful for people juggling multiple calendars (work, personal, team projects) who need unified scheduling views.

Common use cases

• Check cross-calendar availability across work and personal calendars
• Import calendar events from images or PDF invitations
• Detect scheduling conflicts across multiple calendars
• Create and modify recurring events with natural-language dates
• Generate meeting availability for scheduling across teams

Setup pitfalls

• OAuth credentials must be set via the GOOGLE_OAUTH_CREDENTIALS environment variable pointing to a valid gcp-oauth.keys.json file, or requests fail with a -32600 error.
• Test mode tokens expire after 7 days — either re-authenticate weekly or publish your Google Cloud app to production mode.
• Authentication is mandatory before first use — ask Claude to authenticate with Google Calendar before any calendar operation will work.
• The server reads and writes the filesystem to store OAuth tokens — isolate it appropriately if handling sensitive calendar data.