Calendar MCP Server

# 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+ - `uv` package manager (recommended) ### 2. Installation Install dependencies using `uv`: ```bash uv sync ``` ### 3. Configuration Open `main.py` and set the `ICS_URL` constant to your public Google Calendar ICS URL: ```python ICS_URL = "https://calendar.google.com/calendar/ical/YOUR_CALENDAR_ID/public/basic.ics" ``` ## Usage Run the server using `uv`: ```bash uv run main.py ``` ## 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`, and `location`. ### `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].