MCP Google Calendar Server

A Model Context Protocol (MCP) server for creating Google Calendar events.

Setup

1. Install dependencies:

   npm install

2. Get Google Calendar API credentials:

   • Go to Google Cloud Console

   • Create a new project or select existing one

   • Enable the Google Calendar API

   • Create credentials (OAuth 2.0 Client ID)

   • Download the credentials and save as credentials.json in the project root

3. Authenticate:

   • Run the server and use the authenticate_google_calendar tool to get the auth URL

   • Visit the URL, grant permissions, and get the authorization code

   • Create a token.json file with your credentials

4. Configure Claude Code: Add to your MCP settings:

   { "mcpServers": { "google-calendar": { "command": "node", "args": ["/Users/krilet/mcp-google-calendar-server/src/index.js"] } } }

Usage

The server provides two tools:

authenticate_google_calendar

Generates an authentication URL for Google Calendar access.

create_calendar_event

Creates a new event in your Google Calendar.

Parameters:

• summary (required): Event title

• startDateTime (required): Start time in ISO format

• endDateTime (required): End time in ISO format

• description (optional): Event description

• location (optional): Event location

• timeZone (optional): Time zone (defaults to UTC)

• attendees (optional): Array of email addresses

Example: