Google Calendar MCP Server Xon

🚀 Google Calendar MCP Server

A Model Context Protocol (MCP) server that provides tools for interacting with the Google Calendar API. This server enables programmatic management of calendar events through the MCP interface.

🚀 Quick Start

This server offers a set of tools to interact with the Google Calendar API, allowing you to manage calendar events programmatically.

✨ Features

Calendar Tools

• list_events: Filter and display upcoming calendar events by date range.
• create_event: Create a new calendar event and add participants.
• update_event: Update an existing calendar event.
• delete_event: Delete a calendar event.

📦 Installation

Prerequisites

1. Node.js: Install Node.js version 14 or higher.
2. Google Cloud Console Setup:
   • Visit Google Cloud Console.
   • Create a new project or select an existing one.
   • Enable the Google Calendar API:
     1. Go to "APIs & Services" > "Library".
     2. Search for and enable "Google Calendar API".
   • Set up OAuth 2.0 credentials:
     1. Go to "APIs & Services" > "Credentials".
     2. Click "Create Credentials" > "OAuth client ID".
     3. Select "Web application".
     4. Set "Authorized redirect URIs" to: http://localhost:3000/code.
     5. Record the Client ID and Client Secret.

Installation Steps

1. Clone and Install:

   git clone https://github.com/yourusername/google-calendar-mcp-server.git
   cd google-calendar-mcp-server
   npm install
   

2. Create OAuth Credentials: Create a credentials.json file in the root directory:

   {
       "web": {
           "client_id": "YOUR_CLIENT_ID",
           "client_secret": "YOUR_CLIENT_SECRET",
           "redirect_uris": ["http://localhost:3000/code"],
           "auth_uri": "https://accounts.google.com/o/oauth2/auth",
           "token_uri": "https://oauth2.googleapis.com/token"
       }
   }
   

3. Get Refresh Token:

   node get-refresh-token.js
   

   This command will:

   • Open the browser for Google OAuth authentication.
   • Request the following permissions:
     • https://www.googleapis.com/auth/calendar
   • Save the credentials to token.json.
   • Display the refresh token in the console.

4. Configure MCP Settings: Add the server configuration to your MCP settings file:

   • For the VSCode Claude extension: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • For the Claude desktop app: ~/Library/Application Support/Claude/claude_desktop_config.json

   Add the following configuration to the mcpServers object:

   {
     "mcpServers": {
       "google-calendar": {
         "command": "node",
         "args": ["index.js"],
         "cwd": "/path/to/server/directory"
       }
     }
   }
   

💻 Usage Examples

Basic Usage

List Upcoming Events

{
  "action": "list_events",
  "params": {
    "calendarId": "primary", // Optional, default is "primary"
    "timeMin": "2023-12-01T00:00:00Z", // Start time
    "timeMax": "2023-12-31T23:59:59Z", // End time
    "maxResults": 50, // Maximum number of results, default is 25
    "orderBy": "startTime" // Sort by start time, optional values: startTime, endDate
  }
}

Create a New Event

{
  "action": "create_event",
  "params": {
    "calendarId": "primary", 
    "event": {
      "summary": "Meeting", // Event title
      "location": "Online Meeting", // Event location
      "description": "Attend the team meeting", // Event description
      "start": {
        "dateTime": "2023-12-10T10:00:00Z", // Start time
        "timeZone": "Asia/Shanghai" // Time zone
      },
      "end": {
        "dateTime": "2023-12-10T11:00:00Z",
        "timeZone": "Asia/Shanghai"
      }
    }
  }
}

Update an Event

{
  "action": "update_event",
  "params": {
    "calendarId": "primary", 
    "eventId": "abc123", // ID of the event to update
    "event": {
      "summary": "Updated Meeting", // New title
      "description": "Updated meeting content" // New description
    }
  }
}

Delete an Event

{
  "action": "delete_event",
  "params": {
    "calendarId": "primary", 
    "eventId": "abc123"
  }
}

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.