Macbook Calendar Mcp Server
About
An MCP (Model Context Protocol) server that securely integrates with the native macOS Calendar application. It allows AI models to read events and create new events securely using AppleScript without complex dependencies.
Details
- Author
- jayaprakashnarayana
- Downloads
- 333
- Categories
- Productivity
Jump to
- 100% local and private – no cloud relays or iCloud passwords.
- Zero configuration – uses calendars visible in macOS Calendar app.
- Prompt injection protection through parameterized argv shells.
- Native macOS TCC support requiring manual permission grant.
- Tools: list_calendars, get_events, and add_event.
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
Macbook Calendar Mcp ServerCommand (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
No complex installation is required. Add the following configuration to your claude_desktop_config.json file under mcpServers: use the uvx command with the provided Git repository and module name.
list_calendars
get_events
get_event
search_events
get_agenda
calendar_index_status
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"macbook calendar mcp server": {
"mac-calendar": {
"command": "uvx",
"args": [
"--from",
"mac-calendar-mcp",
"mac-calendar-mcp"
]
}
}
}
}McpServers
{
"mac-calendar": {
"command": "uvx",
"args": [
"--from",
"mac-calendar-mcp",
"mac-calendar-mcp"
]
}
}Mac Calendar MCP Server 📅
The Mac Calendar MCP Server is a native, zero-dependency bridge between Claude (or any MCP client) and your local macOS Calendar app. Unlike other calendar integrations that require complex Google Cloud / OAuth configurations or exposing your private iCloud data to third-party web APIs, this server communicates entirely locally using macOS Apple Events. Your calendar data never leaves your machine. ---🔥 Key Benefits
- 100% Local & Private: No iCloud passwords, no OAuth tokens, no cloud relays. It securely reads the local database on your Mac. - Zero Configuration: Whatever calendars are visible in your Mac's Calendar app (Work, Home, Subscribed Calendars) are instantly available to Claude. - Highly Secure Architecture: Engineered to completely thwart prompt injection. User inputs are parameterized strictly asargv shells instead of script interpolation, removing any risk of arbitrary code execution.
- Native TCC Support: Operates respecting macOS Transparency, Consent, and Control. You must manually grant UI permission the very first time it runs, meaning nothing can scrape your calendar silently.
---
🛠️ Tools Included
1.list_calendars
Quickly retrieves a list of all calendar names currently available on your Mac.
2. get_events
Fetches events within a specified date range for a given calendar name. It safely standardizes inputs using ISO-8601 formatting to avoid locale-specific timestamp crashes.
3. add_event
Securely creates a new calendar event, mapping the title, start/end dates, location, and description directly into the Mac Calendar application.
---
🚀 Quick Setup (Claude Desktop)
There is no complex installation required. Simply add this to yourclaude_desktop_config.json:
```json
{
"mcpServers": {
"mac-calendar": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/jayaprakashnarayana/mac-calendar-mcp.git",
"mac-calendar-mcp"
]
}
}
}Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
