mcp-registry/google-calendar-mcp

    ==================
      
       /// MCP ///
      /// GOO ///
        
    ==================
        
    [server:online]
    [protocol:ready]

google-calendar-mcp

by takumi0706

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.

42
3
Open Source
GitHub

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.

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.

Documentation

License: MIT License
Updated 7/15/2025