Calendar App MCP

@rygwdn

About Calendar App MCP

An MCP server for the macOS Calendar.app

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "calendar-app-mcp": {
      "command": "uvx",
      "args": [
        "calendar-app-mcp",
        "#",
        "Automatically",
        "runs",
        "as",
        "MCP",
        "server",
        "with",
        "no",
        "arguments"
      ]
    }
  }
}

Tools

Retrieve events for a specific date range

Retrieve reminders for a specific date range

List all available calendars

Get a summary of today's events and reminders

Search for events and reminders containing a specific term

Get the current date and time in any timezone

Convert a time from one timezone to another

List available timezones, optionally filtered by region

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.

Frequently asked questions

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.

Comments

Basic information

More Productivity MCP servers

Dadan MCP

Dadan-io

dadan-sdk-integration is an SDK for integrating Dadan features into React applications. It allows you to add video recording and file selection functionality directly into your React components, providing a seamless user