Google Calendar MCP Server

This is a Model Context Protocol (MCP) server that integrates with Google Calendar, enabling LLMs to manage calendar events through a standardized interface.

Features

• Calendar Management: Comprehensive event management including listing, viewing, creating, updating, deleting, and managing attendees and reminders. Supports multiple calendars.
• Security & Authentication: Secure OAuth 2.0 authentication with automatic token refresh and secure credential storage.

Example Usage

Dynamic capabilities include adding events from screenshots, calendar analysis, attendance checks, auto-coordinating events, and providing availability.

Requirements

Node.js, TypeScript, a Google Cloud project with the Calendar API enabled, and OAuth 2.0 credentials.

Project Structure

Includes directories for source code (src), compiled JavaScript (build), scripts, LLM configurations (llm), logs, and project configuration files.

Google Cloud Setup

Enable the Google Calendar API in your Google Cloud project and create OAuth 2.0 credentials.

Installation

Clone the repository, install dependencies using npm install, and place your Google OAuth credentials in gcp-oauth.keys.json.

Available Scripts

Scripts for building, type checking, starting the server in development or production mode, and running the authentication flow.

Authentication

Supports automatic and manual OAuth authentication flows, with secure token storage and automatic refresh.

Usage

Exposes MCP tools for calendar management, such as list-calendars, create-event, and update-event.

Using with Claude Desktop

Configuration instructions for integrating with Claude Desktop.

Development

Troubleshooting tips for common issues like OAuth token expiration and build errors.

Security Notes

OAuth credentials and tokens are stored securely. Never commit these files to version control.

License

MIT