Provides read-only access to Google Calendar events via public ICS feeds, enabling listing of events within date ranges and searching events by text query, with automatic handling of recurring events.
Calendar MCP Server - by Rezel, for Rezel
A Model Context Protocol (MCP) server that provides access to Google Calendar events via a public ICS feed.
Features
List Events: Fetch events within a specific date range, handling recurring events automatically.
Search Events: Search for events by text (summary or description) within a 6-month window.
Caching: Implements a 5-minute memory cache to respect rate limits.
Setup
1. Prerequisites
Python 3.11+
uvpackage manager (recommended)
2. Installation
Install dependencies using uv:
3. Configuration
Open main.py and set the ICS_URL constant to your public Google Calendar ICS URL:
Usage
Run the server using uv:
Tools
list_events
Lists events between two dates.
Arguments:
start_date(string, ISO 8601, e.g., "2023-01-01")end_date(string, ISO 8601, e.g., "2023-01-31")
Returns: A list of event objects with
summary,start,end,description, andlocation.
search_events
Searches for events matching a text query.
Arguments:
query(string)
Returns: A list of matching event objects found in the range of [30 days ago, 180 days future].