Overview
What is Calendar App MCP?
Calendar App MCP is an MCP (Model Context Protocol) server that provides access to macOS Calendar.app events and reminders for use with Claude and other AI assistants.
How to use Calendar App MCP?
Install from PyPI with pip install calendar-app-mcp or uv pip install calendar-app-mcp. Run it as an MCP server using uvx calendar-app-mcp or uvx calendar-app-mcp mcp. Once running, AI assistants like Claude can interact with your calendar data through the MCP protocol. You can also use it as a command-line tool with subcommands such as calendars, today, events, reminders, and all.
Key features of Calendar App MCP
- Access macOS Calendar.app events and reminders
- Filter by date range, calendar names, and all-day/busy status
- Format output as JSON or Markdown
- Secure, local access to calendar data
- MCP integration for AI assistants like Claude
Use cases of Calendar App MCP
- Ask Claude for a summary of today’s events and reminders
- Find free time slots for scheduling a meeting
- Search events and reminders containing a specific term
- List available calendars and their details
- Get the current time or convert times between timezones
FAQ from Calendar App MCP
What does Calendar App MCP require to run?
It requires macOS with Calendar.app installed, and the Python package installed via pip or uv.
How does Calendar App MCP access calendar data?
It accesses macOS Calendar.app data locally and securely on your machine without any external services.
Can I use Calendar App MCP with other AI assistants besides Claude?
Yes, it works with any AI assistant that implements the MCP protocol.
What output formats are available?
Output can be formatted as JSON (using the --json flag) or Markdown (default).
How do I run it as an MCP server?
Run uvx calendar-app-mcp or uvx calendar-app-mcp mcp from the command line to start the MCP server.
