Google Calendar MCP Server

🚀 Google Calendar MCP Server

Interact with your Google Calendar using the Model Context Protocol (MCP) via Claude Desktop.

This is a TypeScript-based MCP server that implements Google Calendar integration. While demonstrating core MCP concepts, it offers:

• Access to calendar events via MCP URIs
• Tools for creating and modifying events
• Prompts for automatically generating calendar insights

✨ Features

Resources

• Access calendar events via MCP URIs.
• Each event includes a title, time, description, and attendees.
• Structured event data with the correct MIME type.

Tools

• create_event - Create a new calendar event.
  • Accepts the title, time, and other event details as parameters.
  • Interfaces directly with the Google Calendar API.
• list_events - View upcoming calendar events.
• [Add other tools you've implemented]

Prompts

• analyze_schedule - Generate calendar insights.
  • Includes upcoming events as embedded resources.
  • Returns structured prompts for LLM analysis.
• [Add other prompts you've implemented]

📋 Prerequisites

• Node.js (v14 or higher)
• A Google Cloud project with the Google Calendar API enabled
• OAuth 2.0 client credentials

🛠️ Development

Install devbox following the instructions in devbox.sh:

curl -fsSL https://get.jetpack.io/devbox | bash

Initialize devbox in the project directory:

devbox init

Start the devbox shell:

devbox shell

Install dependencies:

npm install

Build the server:

npm run build

Develop with automatic rebuilds:

npm run watch

📦 Installation

Add the server configuration when using it with Claude Desktop:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "Google Calendar": {
      "command": "/path/to/Google Calendar/build/index.js"
    }
  }
}

🚀 First-time Setup

1. Set up Google Cloud credentials:

   • Go to the Google Cloud Console.
   • Create a new project or select an existing one.
   • Enable the Google Calendar API.
   • Create OAuth 2.0 credentials (desktop application type).
   • Download the client secret JSON file.
   • Rename it to .client_secret.json and place it in the project root directory.

2. Initial authentication:

   • When running the server, it will provide an authentication URL.
   • Visit the URL in your browser.
   • Grant the required permissions.
   • Copy the provided authorization code.
   • Paste the code back into the CLI prompt.

🔧 Debugging

Since MCP servers communicate via stdio, debugging can be challenging. We recommend using MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a browser URL to access the debugging tools.