Integrates with Apple's native Calendar application on macOS, allowing for management of calendar events through AppleScript
Supports accessing and managing Google Calendar events through the macOS Calendar app integration, including creating events and searching existing ones
Works with iCloud calendars through the macOS Calendar app, enabling event management for calendars synced with iCloud accounts
Provides direct integration with macOS Calendar app using AppleScript, enabling creation, listing, and searching of calendar events across all calendar types without requiring OAuth setup
macOS Calendar MCP Server
A Model Context Protocol (MCP) server for seamless macOS Calendar integration using AppleScript. No OAuth setup required!
Features
- 🍎 Native macOS Integration - Uses AppleScript to interact directly with macOS Calendar
- 📅 Full Calendar Management - Create, list, and search calendar events
- 🚀 Zero Configuration - No OAuth, no API keys, just works out of the box
- 🔧 MCP Compatible - Works with Claude Code CLI and other MCP clients
- 📱 Multi-Calendar Support - Works with all your calendars (Personal, Work, etc.)
Quick Start
Prerequisites
- macOS (required for AppleScript support)
- Node.js 16+
- Calendar app (pre-installed on macOS)
Installation
- Clone the repository:
- Install dependencies:
- Grant permissions:
- When first run, macOS will ask for Calendar app permissions
- Grant access to allow the MCP server to manage your calendars
Usage with Claude Code CLI
Add to your .claude_project
file:
Or run directly:
Available Tools
Tool | Description | Parameters |
---|---|---|
list-calendars | List all available calendars | None |
create-event | Create a new calendar event | title , startDate , endDate , calendar , description , location |
list-today-events | List today's events | calendar (optional) |
search-events | Search events by keyword | query , calendar (optional) |
Examples
Create an Event
List Calendars
Search Events
Date Format
Use the format: YYYY-MM-DD HH:MM
(24-hour format)
Examples:
2025-07-05 14:00
(2:00 PM)2025-12-25 09:30
(9:30 AM)2025-07-10 18:00
(6:00 PM)
Time Zone Handling:
- Uses native macOS time handling to avoid timezone conversion issues
- All times are interpreted in your system's local timezone
- No UTC conversion or daylight saving adjustments needed
Supported Calendars
Works with all macOS Calendar calendars including:
- Personal calendars
- Work calendars
- Shared calendars
- Subscribed calendars (iCloud, Google, etc.)
Troubleshooting
Permission Issues
If you get permission errors:
- Open System Preferences → Security & Privacy → Privacy
- Select "Calendar" from the left sidebar
- Ensure Terminal (or your app) has access
AppleScript Errors
- Ensure Calendar app is installed and accessible
- Check calendar names are correct (case-sensitive)
- Verify date formats match the expected pattern
Time Zone Issues
If events appear at wrong times:
- Check your system timezone settings
- Use the
fix-event-times
tool to correct existing events - Ensure date format is
YYYY-MM-DD HH:MM
in 24-hour format - The MCP uses native macOS time handling to avoid conversion issues
Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Test thoroughly on macOS
- Submit a pull request
License
MIT License - see LICENSE file for details.
Why This MCP?
Unlike Google Calendar integrations that require complex OAuth setups, this MCP:
- ✅ Works immediately with no configuration
- ✅ Integrates with your existing macOS Calendar setup
- ✅ Supports all calendar sources (iCloud, Google, Exchange, etc.)
- ✅ Requires no internet connection for basic operations
- ✅ Respects your privacy - everything runs locally
Perfect for developers who want calendar integration without the OAuth headache!
Privacy & Security
- ✅ Local Processing: All calendar operations run locally on your machine
- ✅ No Data Upload: Your calendar data never leaves your device
- ✅ Privacy Focused: No OAuth tokens, no cloud services, no tracking
- ⚠️ Private Data: When testing, avoid committing files containing personal events to public repositories
Data Protection
The project includes .gitignore
patterns to prevent accidental commits of private event data:
*events*.json
- Event data files*meetings*.json
- Meeting schedules*schedule*.json
- Schedule filesprivate-*.json
- Any private data files
This server cannot be installed
A Model Context Protocol server that enables direct integration with macOS Calendar application using AppleScript, allowing users to create, list, and search calendar events without requiring OAuth setup.
Related MCP Servers
- -securityAlicense-qualityTransforms macOS calendar management into a conversational experience using natural language, allowing users to create, manage, and update calendar events seamlessly through an MCP-compatible client.Last updated -64PythonMIT License
- -securityAlicense-qualityEnables comprehensive calendar management with capabilities to create, list, update, and delete events through a Model Context Protocol server integrated with Google Calendar.Last updated -131TypeScriptMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that provides tools for interacting with Gmail and Calendar APIs, enabling programmatic management of emails and calendar events.Last updated -813JavaScriptMIT License
- -securityFlicense-qualityA Model Context Protocol server for AI models to access and manipulate Apple Calendar data on macOS through a standardized interface.Last updated -5TypeScript