A Model Context Protocol server for macOS Calendar.app
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"calendar-sse-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Calendar SSE MCP [English](README.md) | [中文](README_CN.md) | [GitHub](https://github.com/HongpengM/calendar-sse-mcp) A [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server for interacting with macOS Calendar. ## Features - List all calendars from macOS Calendar.app - Get events from specific calendars - Filter events by date range - Create, update, and delete calendar events - Search for events by text query - Provides both MCP resources and tools for AI assistants - Includes prompt templates for common operations - Comprehensive command-line interface for all operations - Built-in launch agent support for background operation - JSON API endpoints for programmatic access - Robust date parsing using dateparser library - Data validation with Pydantic v2 - Dynamic launch agent detection and installation ## Requirements - macOS (tested on macOS 14 Sonoma and above) - Python 3.10 or newer - Calendar.app with at least one calendar set up ## Installation ### From Source Clone the repository and install: ```bash git clone https://github.com/HongpengM/calendar-sse-mcp.git # or your fork cd calendar-sse-mcp pip install -e . ``` ### Using uv You can install directly using [uv](https://github.com/astral-sh/uv), a fast Python package installer: ```bash uv pip install git+https://github.com/HongpengM/calendar-sse-mcp.git ``` Note: This package will be available on PyPI in the future. ```bash uv pip install calendar-sse-mcp ``` ## Running the Server ### Using `uvx` install the Launch Agent and run commands The easiest way to install and run the calendar service is with uvx: ```bash # Install the server as a Launch Agent with default settings (port 27212) uvx --from calendar-sse-mcp calendar-sse server install # Customize the installation uvx --from calendar-sse-mcp calendar-sse server install --port 5000 --logdir ~/logs # Install a development server on port 27213 uvx --from calendar-sse-mcp calendar-sse server install --dev # Start the…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.