Google Calendar

Google Calendar

MCP server providing Google Calendar integration for AI assistants and multi-calendar management.

782
Stars
237
Forks
14
Releases

Overview

An MCP server that integrates Google Calendar with AI assistants. It enables multi-calendar management by listing events from multiple calendars, and supports creating, updating, deleting, and searching calendar events. It also handles advanced modifications for recurring events and provides free/busy queries to check availability across calendars. The server includes smart scheduling through natural language understanding for dates and times, and offers intelligent import of events from images, PDFs, or web links, allowing adding events from screenshots or other data sources. It exposes a suite of MCP tools such as list-calendars, list-events, search-events, create-event, update-event, delete-event, get-freebusy, and list-colors. Deployment options include npx, local installation, and Docker, with configuration via environment variables like GOOGLE_OAUTH_CREDENTIALS. Security considerations include local storage of OAuth tokens and explicit user consent for operations; in test mode tokens expire after seven days, with production mode removing expiry. Prerequisites include a Google Cloud project with Calendar API enabled and OAuth 2.0 credentials. The README also references documentation and troubleshooting materials for authentication, deployment, and usage.

Details

Owner
nspady
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

Multi-Calendar Support

List events from multiple calendars simultaneously

Event Management

Create, update, delete, and search calendar events

Recurring Events

Advanced modification capabilities for recurring events

Free/Busy Queries

Check availability across calendars

Smart Scheduling

Natural language understanding for dates and times

Inteligent Import

Add calendar events from images, PDFs or web links

Audience

AI assistantsIntegrate Google Calendar capabilities into Claude-like AI assistants for event management, scheduling, and availability across multiple calendars.

Tags

Google CalendarMCPAI assistantsmulti-calendareventsschedulingrecurring eventsfree/busyimportOAuthGoogle CloudDockernpxClaude