ProductivityCommunity

Google Calendar

Create, update, and query calendar events with support for recurring events and attendee management.

Overview

A Google Calendar MCP server lets an AI assistant see your schedule, find free slots, create and update events, and add attendees. A concrete example: "look at my week and find three 45-minute gaps for deep work, then block them." There is no official reference Calendar server from the MCP project; npx @modelcontextprotocol/server-gcal does not exist. The realistic choices are Claude's built-in Google Calendar connector (a one-time sign-in, no installation) or a maintained community server such as nspady's google-calendar-mcp if you self-host or use another client.

Access works through Google's OAuth consent flow: you approve calendar scopes with your own account, the grant covers only your calendars, and you can revoke it anytime from your Google account's security page. Creating or moving events is a write action, so clients ask before changes are made.

Instructions

Use the built-in connector if you canIn Claude's Settings under Connectors, connect Google Calendar and approve the Google sign-in. This is the maintained, zero-setup route and covers reading your schedule and creating events. Only continue to self-hosting if you need another client or local control.
Self-hosted: set up OAuth credentialsIn Google Cloud Console, enable the Google Calendar API and create an OAuth client of type Desktop app. Download the credentials JSON and point the server at it with the GOOGLE_OAUTH_CREDENTIALS environment variable.
Add the server and sign inClaude Desktop: add an mcpServers entry with command "npx", args ["@cocal/google-calendar-mcp"], and env GOOGLE_OAUTH_CREDENTIALS set to the JSON path. On first run a browser opens for Google sign-in; approve the calendar scopes once.
Run a first testAsk: "What is on my calendar tomorrow?" then something gently write-shaped like "Create a 30-minute hold called Focus time at 9am Friday." Confirm the tool prompts. If auth fails, re-check the credentials path and that the Calendar API is enabled.

Starter recipes

Real tasks you can ask an agent once this server is connected.

Plan the week in one ask

Have the assistant review next week, list days that are over-booked, and propose a rebalanced plan. Then, after you approve, have it move the flexible events and add two protected focus blocks.

Try

Schedule around busy times

Ask it to find the first 60-minute slot you and a named coworker's shared calendar both have free next week, create the event, add them as an attendee, and include an agenda in the description.

Try

Morning briefing

Each morning, ask for today's events in order with travel-time warnings for anything with a location, plus a note of which meetings have no agenda so you can chase one.

Try

Install

No install command: we could not confirm this project's repository.

Not confirmed: install command (no repository); download count (no confirmed package); repository (not found on GitHub).

License

MIT

Community-maintained

Access

Access is scoped by the Google OAuth grant to your own calendars and is revocable anytime from your Google account's security settings. Viewing the schedule and editing events are distinct permissions, and event changes should always go through a confirmation step in your client.

Google Calendar

Starter recipes

Plan the week in one ask

Schedule around busy times

Morning briefing

One AI recipe you can use.Every Monday.

One AI recipe you can use.
Every Monday.