macOS Calendar

Provides a local MCP server to manage macOS Calendar events using AppleScript, with zero OAuth and offline operation.

javascript

6

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

This MCP server enables native macOS Calendar integration by driving Calendar through AppleScript, managed locally on your Mac. It lets you create, list, and search events without any OAuth or cloud dependencies, so you can stay fully offline while touching all your calendars from a streamlined MCP client workflow.

How to use

You can use this MCP server with any MCP client by running it locally or by configuring your client to launch the server as a stdio process. The server exposes calendar operations such as listing calendars, creating events, listing today’s events, and searching for events. All actions run on your Mac using AppleScript, without external authentication.

To run it directly, start the server with Node from the project root: node macos-calendar-mcp.js.

To integrate with a Claude Code CLI workflow, add an MCP server entry to your project configuration as shown below. This lets Claude Code CLI start and communicate with the local MCP server automatically.

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

Examples of common tasks you can perform

Create a new event by providing a title, start time, end time, and optional details like calendar, description, and location.

List all calendars to understand which sources you have available (Personal, Work, Shared, etc.).

List today’s events to quickly see current-day commitments.

Search for events by a keyword within a specific calendar if needed.

Available tools

list-calendars

List all available calendars in your macOS Calendar setup.

create-event

Create a new calendar event with a title, startDate, endDate, calendar, and optional description and location.

list-today-events

List today’s events, optionally filtered by a specific calendar.

search-events

Search events by a keyword, optionally restricted to a calendar.