MCP Google Calendar Server

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

Setup

1. Install dependencies:

   Copy

   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:

   Copy

   {
     "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:

{
  "summary": "Team Meeting",
  "startDateTime": "2024-12-25T10:00:00-08:00",
  "endDateTime": "2024-12-25T11:00:00-08:00",
  "description": "Weekly team sync",
  "location": "Conference Room A",
  "attendees": ["colleague@example.com"]
}