eventkit-rs

A Rust library and CLI for interacting with macOS Calendar events and Reminders via Apple's EventKit framework. Includes a built-in Model Context Protocol (MCP) server for AI assistant integration.

Features

• Calendar Events — Create, read, update, and delete calendar events with alarms, recurrence, attendees, and structured location
• Reminders — Full CRUD for reminders with priority, alarms, recurrence, tags, and URL support
• MCP Server — Built-in MCP server (--mcp) with structured JSON output, input/output schemas, and 26 tools
• Calendar Management — Create, update (name + color), and delete both reminder lists and event calendars
• Batch Operations — Batch delete, move, and update across reminders and events
• Location — Get current location via CoreLocation for geofenced reminders
• In-Process Transport — Embed as a library with serve_on() for DuplexStream-based in-process MCP
• CLI + Dump — Command-line tool with JSON dump for debugging raw EventKit objects

Requirements

• macOS 14+ (Sonoma)
• Rust 1.94+

Installation

As a CLI Tool

cargo install eventkit-rs

As a Library

[dependencies]
eventkit-rs = "0.3"

Without MCP dependencies:

[dependencies]
eventkit-rs = { version = "0.3", default-features = false, features = ["events", "reminders"] }

Quick Start

Library Usage

use eventkit::{RemindersManager, EventsManager};

fn main() -> eventkit::Result<()> {
    // Reminders
    let reminders = RemindersManager::new();
    reminders.request_access()?;

    let reminder = reminders.create_reminder(
        "Buy groceries",
        Some("Milk, eggs, bread"),
        None, Some(1), None, None,
    )?;

    for item in reminders.fetch_incomplete_reminders()? {
        println!("- {}", item.title);
    }

    // Calendar Events
    let events = EventsManager::new();
    events.request_access()?;

    for event in events.fetch_today_events()? {
        println!("{} at {}", event.title, event.start_date);
    }

    Ok(())
}

In-Process MCP (no separate binary)

use tokio::io::duplex;

// One end for the MCP client, one for the server
let (client_stream, server_stream) = duplex(64 * 1024);

// Spawn the EventKit MCP server in-process
tokio::spawn(async move {
    eventkit::mcp::serve_on(server_stream).await.unwrap();
});

// Connect your MCP client to client_stream...

CLI Usage

# MCP server (stdio transport)
eventkit --mcp

# Reminders
eventkit reminders authorize
eventkit reminders lists
eventkit reminders list --all
eventkit reminders add "Call mom" --notes "Birthday" --priority 1
eventkit reminders complete <id>
eventkit reminders delete <id> --force

# Calendar Events
eventkit events authorize
eventkit events calendars
eventkit events list --today
eventkit events list --days 14 --all
eventkit events add "Meeting" --start "2026-03-22 14:00" --duration 60
eventkit events add "Holiday" --start "2026-03-25" --all-day
eventkit events delete <id> --force

# Dump objects as JSON (for debugging)
eventkit dump reminder-lists
eventkit dump calendars
eventkit dump sources
eventkit dump reminder <id>
eventkit dump reminders --list "Shopping"
eventkit dump event <id>
eventkit dump events --days 30

MCP Server

Tools (26)

All tools return structured JSON with typed output schemas. Responses use structured_content (MCP spec 2025-06-18) with text fallback for older clients.

Prompts (4)

Configuration

Add to your MCP client config (e.g. Claude Desktop):

{
  "mcpServers": {
    "eventkit": {
      "command": "eventkit",
      "args": ["--mcp"]
    }
  }
}

Privacy Permissions

Add to your Info.plist:

<key>NSRemindersFullAccessUsageDescription</key>
<string>This app needs access to your reminders.</string>

<key>NSCalendarsFullAccessUsageDescription</key>
<string>This app needs access to your calendar.</string>

<key>NSLocationWhenInUseUsageDescription</key>
<string>This app needs your location for location-based reminders.</string>

Feature Flags

Development

# Run all checks (same as CI)
./ci-check.sh

# Auto-fix formatting + clippy
./ci-check.sh --fix

# Build universal binary (arm64 + x86_64)
./build-universal.sh

License

Apache 2.0 — see LICENSE.