Calendar App MCP
About
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.
Details
- License
- MIT
Explore
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Calendar App MCPCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
pip install calendar-app-mcp
uvx calendar-app-mcp calendars
uvx calendar-app-mcp mcp
calendar-app-mcp
Both commands support the same subcommands, but calendar-app-mcp is optimized for use as an MCP server.
uv install -e .
uv install -e '.[dev]'
In addition to functioning as an MCP server, this package can be used as a command-line tool to access calendar data directly:
UV_NO_CONFIG=1 uv install
The UV_NO_CONFIG=1 environment variable tells UV to ignore any system-level configuration and use only the public PyPI registry.
Run all tests:
python -m pytest
Run tests with coverage report:
python -m pytest --cov=calendar_app
Run specific test file:
python -m pytest tests/unit/utils/test_date_utils.py
Run specific test:
python -m pytest tests/unit/utils/test_date_utils.py::TestParseDate::test_valid_date
```
get_events
Retrieve events for a specific date range
get_reminders
Retrieve reminders for a specific date range
list_calendars
List all available calendars
get_today_summary
Get a summary of today's events and reminders
search
Search for events and reminders containing a specific term
get_current_time
Get the current date and time in any timezone
convert_time
Convert a time from one timezone to another
list_timezones
List available timezones, optionally filtered by region
- get_events: Retrieve events for a specific date range
- get_reminders: Retrieve reminders for a specific date range
- list_calendars: List all available calendars
- get_today_summary: Get a summary of today's events and reminders
- search: Search for events and reminders containing a specific term
- get_current_time: Get the current date and time in any timezone
- convert_time: Convert a time from one timezone to another
- list_timezones: List available timezones, optionally filtered by region
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"calendar app mcp": {
"calendar-app-mcp": {
"command": "uvx",
"args": [
"calendar-app-mcp",
"#",
"Automatically",
"runs",
"as",
"MCP",
"server",
"with",
"no",
"arguments"
]
}
}
}
}McpServers
{
"calendar-app-mcp": {
"command": "uvx",
"args": [
"calendar-app-mcp",
"#",
"Automatically",
"runs",
"as",
"MCP",
"server",
"with",
"no",
"arguments"
]
}
}An MCP (Model Context Protocol) server that provides access to macOS Calendar.app events and reminders for use with Claude and other AI assistants.
MCP Integration
This package can be run as an MCP server to integrate with Claude and other AI assistants supporting the MCP protocol, enabling them to access and interact with your macOS calendar data.
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
