Google Calendar MCP Server Xke

🚀 Google Calendar MCP Server

This MCP server provides integration with Google Calendar, allowing Claude to view, create, and manage calendar events through a unified interface.

🚀 Quick Start

This Google Calendar MCP Server enables seamless interaction with Google Calendar. It offers a range of functions to manage calendar events efficiently.

✨ Features

• List available calendars
• List events from a single calendar
• Create new calendar events
• Update existing events
• Delete events

📦 Installation

Prerequisites

• Node.js version 16 or higher
• Enable the Calendar API in your Google Cloud project
• OAuth 2.0 credentials (client ID and client secret)

Google Cloud Setup

1. Visit the Google Cloud Console.
2. Create a new project or select an existing one.
3. Enable the Google Calendar API.
4. Create OAuth 2.0 credentials:
   • Navigate to Credentials.
   • Click “Create credentials” > “OAuth client ID”.
   • Select “Desktop app” as the application type.
   • Give it a name (e.g., “Google Calendar MCP”).
   • Download the credentials JSON file.
   • Rename the downloaded file to gcp-oauth.keys.json and place it in the project's root directory.

Installation Steps

1. Install dependencies:

   npm install
   

2. Build the TypeScript code:

   npm run build
   

3. Update the Claude MCP settings file to include this server:
   • Add the following to cline_mcp_settings.json:

   "github.com/pashpashpash/google-calendar-mcp": {
     "command": "node",
     "args": ["C:/Users/ralph/Documents/Cline/MCP/google-calendar-mcp/build/index.js"],
     "env": {},
     "disabled": false,
     "autoApprove": []
   }
   

🔧 Technical Details

Authentication Process

When using the Google Calendar MCP server for the first time, it will:

1. Detect that you don't have an authentication token.
2. Start an authentication server (on ports 3000 - 3004).
3. Open a browser window for OAuth authentication.
4. Securely save the authentication token.
5. Close the authentication server and continue normal operation.

Your authentication token will be stored in .gcp-saved-tokens.json and will be automatically refreshed.

Available Tools

💻 Usage Examples

Basic Usage

List Calendars

list-calendars

List Events

list-events
calendarId: "primary"
timeMin: "2023-01-01T00:00:00Z"
timeMax: "2023-12-31T23:59:59Z"
maxResults: 10

Create Event

create-event
calendarId: "primary"
summary: "Team Meeting"
location: "Meeting Room B"
description: "Weekly team sync meeting"
startDateTime: "2023-06-15T10:00:00"
endDateTime: "2023-06-15T11:00:00"

Update Event

update-event
eventID: "eventId123"
calendarId: "primary"
summary: "Updated Team Meeting"
description: "Updated meeting description"

Delete Event

delete-event
eventID: "eventId123"
calendarId: "primary"

📚 Documentation

Troubleshooting

• If you can't connect to Google Calendar, check your network connection and API permissions.
• Ensure the gcp-oauth.keys.json file exists and is configured correctly.