Skip to content
AgentIntentCode ReviewSlackCLIRemote AgentsContext Engine MCPChangelog
Context EnginePricingDocsBlog
CustomersCareersContextWikiStatus PageTrust CenterSecurity
Talk to SalesSign in
Install
mcp-registry/google-calendar-mcp
google-calendar-mcp logo

google-calendar-mcp

Author: takumi0706

Description: Google Calendar MCP server that lets Claude Desktop read, create, update and delete Google Calendar events via an MCP interface. Implements OAuth2 (PKCE) authentication, token encryption and full event-management tooling.

Stars: 42

Forks: 3

License: MIT License

Category: Open Source

GitHub

Overview

Installation

1. Clone the repository
git clone https://github.com/takumi0706/google-calendar-mcp.git cd google-calendar-mcp
2. Install dependencies (TypeScript / Node.js ≥18 recommended)
npm install
3. Build (optional – the dev server can run with ts-node)
npm run build # outputs to ./dist
or run directly in-place:
npx ts-node src/index.ts
4. Configure Google credentials – create a ```.env``` file or export the variables in your shell:
GOOGLE_CLIENT_ID=<OAuth-client-id> GOOGLE_CLIENT_SECRET=<OAuth-client-secret> GOOGLE_REDIRECT_URI=<https://your-domain.com/oauth> GOOGLE_REFRESH_TOKEN=<offline-access-refresh-token> PORT=3333 # optional, default 3000
5. Start the MCP server
npm start # or: node dist/index.js if built
6. Expose the port if you are testing locally (e.g. with ngrok) and register the public URL as an MCP endpoint inside Claude Desktop.

01

getEvents

Retrieve calendar events with filtering and sorting options such as calendar ID, time range, maximum results, and order.

02

createEvent

Create a new Google Calendar event with details like summary, description, location, start and end times, attendees, color, and optional recurrence rules.

03

updateEvent

Update an existing calendar event, supporting partial updates and modification of recurrence patterns while preserving unspecified fields.

04

deleteEvent

Delete a specified calendar event from a calendar.

05

authenticate

Re-authenticate with Google Calendar, allowing users to switch Google accounts without restarting the application.

License: MIT License
Updated 7/15/2025