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.

Related MCP server: ICS Calendar MCP Server

Setup

1. Prerequisites

• Python 3.11+

• uv package manager (recommended)

2. Installation

Install dependencies using uv:

uv sync

3. Configuration

Open main.py and set the ICS_URL constant to your public Google Calendar ICS URL:

ICS_URL = "https://calendar.google.com/calendar/ical/YOUR_CALENDAR_ID/public/basic.ics"

Usage

Run the server using uv:

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].