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
8Retrieve 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.
Basic information
More Productivity MCP servers
Swift MCP GUI Server
NakaokaReiMCP server that can execute commands such as keyboard input and mouse movement on macOS
MCP SAP GUI Server
mario-andreschakMCP server that allows simple SAP GUI interaction for LLM models using simulated mouse clicks and keyboard input.
mcp-server-macos-use
mediar-aiAI agent that controls computer with OS-level tools, MCP compatible, works with any model
MCP Windows Desktop Automation
mario-andreschakA Model Context Protocol (MCP) server for Windows desktop automation using AutoIt.
Outlook Calendar MCP Tool
merajmehrabiA Model Context Protocol (MCP) server that allows Claude to access and manage your local Microsfot Outlook calendar (Windows only).
Comments