google-calendar-mcp

google-calendar-mcp

284
calendar_management

The Google Calendar MCP Server is a protocol server that facilitates integration with Google Calendar for advanced event management using standardized interfaces. It features dynamic event operations including automated scheduling from images and robust calendar analysis tools. This project emphasizes seamless calendar data interaction via OAuth authentication.

Google Calendar MCP Server

This project is a Model Context Protocol (MCP) server for integrating with Google Calendar. It allows users to interact with their calendars using LLMs to read, create, update, and search for events through a standardized interface.

Features

  • Add events using screenshots and images.
  • Perform calendar analysis and check attendance.
  • Automatically coordinate events and check availability.

Requirements

  • Node.js (Latest LTS)
  • TypeScript 5.3+
  • Google Cloud project with Calendar API enabled
  • OAuth 2.0 credentials

Installation

  1. Clone the repository.
  2. Install dependencies.
  3. Configure Google OAuth credentials.

Available Scripts

  • Build with npm run build.
  • Authenticate with npm run auth.
  • Start server with npm run start.
  • Test with npm test.

Usage

  • Authenticate using OAuth to access calendar data.
  • Supports auto and manual authentication flows.

Security

  • Runs locally and requires OAuth authentication.
  • Ensure credentials and tokens are not committed to version control.