Calendar App MCP logo

Calendar App MCP

by rygwdn

Calendar App MCP is an MCP server that provides access to macOS Calendar.app events and reminders for use with Claude and other AI assistants. It enables AI assistants to interact with your macOS calendar data.

View on GitHub

Last updated: N/A

What is Calendar App MCP?

Calendar App MCP is a server that implements the Model Context Protocol (MCP) to provide AI assistants like Claude with access to events and reminders from macOS Calendar.app.

How to use Calendar App MCP?

To use Calendar App MCP, install the package and run it as an MCP server. Then, configure your AI assistant to connect to the server. The server can also be used as a command-line tool to access calendar data directly.

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

Use cases of Calendar App MCP

  • Checking upcoming events

  • Finding free time slots

  • Viewing event details

  • Accessing reminders

FAQ from Calendar App MCP

How do I install the package?

Use the command uv install -e .

How do I run the server?

Use the command uv run calendar-app mcp

How do I list available calendars?

Use the command uv run calendar-app calendars

How do I get today's events and reminders?

Use the command uv run calendar-app today

How do I filter events by date range?

Use the --from and --to options with the events subcommand.