Skip to main content
Glama

macOS Calendar MCP Server

by xybstone
MIT License
1
  • Apple

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

  1. Clone the repository:
git clone https://github.com/xybstone/macos-calendar-mcp.git cd macos-calendar-mcp
  1. Install dependencies:
npm install
  1. 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:

{ "mcpServers": { "macos-calendar": { "command": "node", "args": ["/path/to/macos-calendar-mcp/macos-calendar-mcp.js"] } } }

Or run directly:

node macos-calendar-mcp.js

Available Tools

ToolDescriptionParameters
list-calendarsList all available calendarsNone
create-eventCreate a new calendar eventtitle, startDate, endDate, calendar, description, location
list-today-eventsList today's eventscalendar (optional)
search-eventsSearch events by keywordquery, calendar (optional)

Examples

Create an Event

{ "title": "Team Meeting", "startDate": "2025-07-05 14:00", "endDate": "2025-07-05 15:00", "calendar": "Work", "description": "Weekly team sync", "location": "Conference Room A" }

List Calendars

// Returns all available calendars

Search Events

{ "query": "meeting", "calendar": "Work" }

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:

  1. Open System Preferences → Security & Privacy → Privacy
  2. Select "Calendar" from the left sidebar
  3. 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:

  1. Check your system timezone settings
  2. Use the fix-event-times tool to correct existing events
  3. Ensure date format is YYYY-MM-DD HH:MM in 24-hour format
  4. The MCP uses native macOS time handling to avoid conversion issues

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Test thoroughly on macOS
  5. 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 files
  • private-*.json - Any private data files
-
security - not tested
A
license - permissive license
-
quality - not tested

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.

  1. Features
    1. Quick Start
      1. Prerequisites
      2. Installation
      3. Usage with Claude Code CLI
    2. Available Tools
      1. Examples
        1. Create an Event
        2. List Calendars
        3. Search Events
      2. Date Format
        1. Supported Calendars
          1. Troubleshooting
            1. Permission Issues
            2. AppleScript Errors
            3. Time Zone Issues
          2. Contributing
            1. License
              1. Why This MCP?
                1. Privacy & Security
                  1. Data Protection

                    Related MCP Servers

                    • -
                      security
                      A
                      license
                      -
                      quality
                      Transforms 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 -
                      64
                      Python
                      MIT License
                      • Apple
                    • -
                      security
                      A
                      license
                      -
                      quality
                      Enables comprehensive calendar management with capabilities to create, list, update, and delete events through a Model Context Protocol server integrated with Google Calendar.
                      Last updated -
                      13
                      1
                      TypeScript
                      MIT License
                    • A
                      security
                      A
                      license
                      A
                      quality
                      A Model Context Protocol server that provides tools for interacting with Gmail and Calendar APIs, enabling programmatic management of emails and calendar events.
                      Last updated -
                      8
                      13
                      JavaScript
                      MIT License
                      • Apple
                    • -
                      security
                      F
                      license
                      -
                      quality
                      A Model Context Protocol server for AI models to access and manipulate Apple Calendar data on macOS through a standardized interface.
                      Last updated -
                      5
                      TypeScript
                      • Apple

                    View all related MCP servers

                    MCP directory API

                    We provide all the information about MCP servers via our MCP API.

                    curl -X GET 'https://glama.ai/api/mcp/v1/servers/xybstone/macos-calendar-mcp'

                    If you have feedback or need assistance with the MCP directory API, please join our Discord server