Google Calendar MCP server
Allow AI systems to list, create, update, and manage Google Calendar events.
1 stars48 downloads/wk
Reviews
Write oneNobody has reviewed Google Calendar yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Google Calendar tools (15, 6 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
acl_listList who has access to a calendar and their permission levels.
calendarlist_deletewrite actionRemove a calendar from the user's calendar list. This unsubscribes from the calendar but does not delete it.
calendarlist_insertwrite actionAdd an existing calendar to the user's calendar list. Use this to subscribe to shared calendars.
calendarlist_updatewrite actionUpdate user-specific settings for a calendar (color, visibility, reminders, custom name).
calendars_listList all calendars the user has access to
colors_getGet the color definitions available for calendars and events. Returns color IDs that can be used with calendarlist_update.
event_createwrite actionCreate a new calendar event. Can include attendees and optionally create a Google Meet link.
event_deletewrite actionDelete a calendar event
event_getGet details of a specific calendar event
event_instancesGet all instances of a recurring event within a time range.
event_moveMove an event to a different calendar. Changes the event organizer. Only works for default events (not birthday, focusTime, etc.).
event_respondRSVP to a calendar event invitation (accept, decline, or tentative)
event_updatewrite actionUpdate an existing calendar event. Only specified fields will be changed.
events_listList calendar events within a time range. Returns events with their details including attendees and response status.
freebusy_queryFind free and busy times for calendars within a time range. Useful for finding meeting availability.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan47 source files scanned; 47 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 18 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Google Calendar compares
Against every graded Productivity MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 60% of 1,301 Productivity servers
- Tools
- 15
- the typical Productivity server has 7
- Tools that change things
- 40%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 50% of 855 Productivity servers
- Downloads a week
- 48
- more than 36% of 433 Productivity servers with a package
What its tools let an agent do: 9 read · 6 change
Install Google Calendar in Claude Code, Cursor or VS Code
Runs npx -y google-cal-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add google-cal-mcp -- npx -y google-cal-mcp
What the publisher says
From the Google Calendar repository's README, as published. We do not edit it. Read it on GitHub
google-cal-mcp
MCP server for Google Calendar - list, create, update, and manage calendar events.
Use Cases
Schedule meetings: "Set up a 30-min sync with Sarah next week" → finds a free slot, creates the event with a Meet link, and sends the invite.
RSVP to invites: "Accept the team offsite but decline the vendor demo" → responds to pending invitations automatically.
Find availability: "When am I free this Thursday afternoon?" → queries your calendar and returns open slots.
Reschedule events: "Move my 1:1 with Alex to Friday at 2pm" → updates the event and notifies attendees.
Daily briefing: "What's on my calendar today?" → lists all events with times, locations, and attendees.
Block focus time: "Block 2 hours tomorrow morning for deep work" → creates a calendar event to protect your time.
(These are just examples - any workflow that needs calendar access can use this.)
Setup
1. Create Google OAuth credentials
- Go to Google Cloud Console
- Create a new project (or use existing)
- Enable the Google Calendar API
- Go to APIs & Services → OAuth consent screen, set up consent screen
- Go to APIs & Services → Credentials → Create Credentials → OAuth client ID
- Choose Web application
- Add http://localhost:3000/callback to Authorized redirect URIs
- Note your Client ID and Client Secret
2. Run the server
GOOGLE_CLIENT_ID='your-client-id' \
GOOGLE_CLIENT_SECRET='your-client-secret' \
MCP_TRANSPORT=http \
npm startThe server runs on http://localhost:3000 by default. Change with PORT=3001.
3. Add to your MCP client
With the server running, follow the instructions on install-mcp, which generates the right config for your MCP client (Claude Code, Claude Desktop, Cursor, Cline, VS Code, and more).
Architecture
This server acts as an OAuth proxy to Google:
graph LR
A[MCP client] <--> B[google-cal-mcp] <--> C[Google OAuth/API]- Server advertises itself as an OAuth authorization server via /.well-known/oauth-authorization-server
- /register returns the Google OAuth client credentials
- /authorize redirects to Google, encoding the client's callback URL in state
- /callback receives the code from Google and forwards to the client's callback
- /token proxies token requests to Google, injecting client credentials
- /mcp handles MCP requests, using the bearer token to call Calendar API
The server holds no tokens or state - it just proxies OAuth to Google.
Tools
Calendar API Scopes
- calendar - Full access to calendars
- calendar.events - Read/write events
Contributing
Pull requests are welcomed on GitHub! To get started:
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Google Calendar: common questions
- Is Google Calendar MCP server safe?
- Mostly: it is graded B (83/100). Read the Google Calendar safety report
- How do I install Google Calendar?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Google Calendar need an API key?
- Yes. The registry entry asks for
GOOGLE_ACCESS_TOKEN,GOOGLE_CLIENT_SECRET. - Is Google Calendar maintained?
- The last commit was 56 days ago (2026-09-09). The latest release is v1.1.3.
- What can I use instead of Google Calendar?
- Servers from other publishers that do the same job: Agent-Native Calendar MCP server, Caldav MCP server and Apple Calendar MCP server. Compare all Google Calendar alternatives.
- How does Google Calendar compare with other Productivity MCP servers?
- safety score 83/100 (higher than 60% of 1,301 Productivity servers); tools 15 (the typical Productivity server has 7); tools that change things 40% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Google Calendar
Same job from other publishers: the closest match first, then the best rated.
- Agent-Native CalendarAgent-Native Google Calendar - manage events, sync, and public bookingnot reviewedEstablishedA
- CaldavCalDAV calendar operations (list, create, update, delete events) as MCP tools.not reviewedEstablishedB
- Apple CalendarList, create, update, and delete events in Apple Calendar on macOS.not reviewedEstablishedA
- Google Drive MCPSecure access to Google Drive, Docs, Sheets, Slides, and Calendar through MCP.not reviewedGrowingB
- not reviewedGrowingB