eventkit-rs

A Rust library and CLI for interacting with macOS Calendar events and Reminders via Apple's EventKit framework.

Features

📅 Calendar Events: Create, read, update, and delete calendar events
✅ Reminders: Full CRUD operations for reminders/tasks
🔐 Authorization: Safe handling of macOS privacy permissions
🦀 Pure Rust: Built on objc2 for safe Objective-C interop
💻 CLI Included: Command-line tool for quick access

Installation

As a Library

Add to your Cargo.toml:

[dependencies]
eventkit-rs = "0.1"

As a CLI Tool

cargo install eventkit-rs

Quick Start

Library Usage

use eventkit::{RemindersManager, EventsManager, Result};

fn main() -> Result<()> {
    // === Working with Reminders ===
    let reminders = RemindersManager::new();

    // Request access (required on first use)
    reminders.request_access()?;

    // Create a reminder
    let reminder = reminders.create_reminder(
        "Buy groceries",
        Some("Milk, eggs, bread"),
        None,  // Use default list
        Some(1),  // High priority
    )?;
    println!("Created: {}", reminder.title);

    // List incomplete reminders
    for item in reminders.fetch_incomplete_reminders()? {
        println!("- {} ({})", item.title, if item.completed { "✓" } else { "○" });
    }

    // Complete a reminder
    reminders.complete_reminder(&reminder.identifier)?;

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

    // List today's events
    for event in events.fetch_today_events()? {
        println!("📅 {} at {}", event.title, event.start_date);
    }

    // Create an event
    use chrono::{Local, Duration};
    let start = Local::now() + Duration::hours(1);
    let end = start + Duration::hours(2);

    let event = events.create_event(
        "Team Meeting",
        start,
        end,
        Some("Discuss Q4 planning"),
        Some("Conference Room A"),
        None,  // Use default calendar
        false, // Not all-day
    )?;

    Ok(())
}

CLI Usage

# Check authorization status
eventkit status
eventkit status --events

# === Reminders ===

# Request authorization
eventkit reminders authorize

# List reminder lists
eventkit reminders lists

# List incomplete reminders
eventkit reminders list

# List all reminders with details
eventkit reminders list --all

# Create a reminder
eventkit reminders add "Call mom" --notes "Birthday wishes" --priority 1

# Complete a reminder
eventkit reminders complete <id>

# Delete a reminder
eventkit reminders delete <id> --force

# === Calendar Events ===

# Request authorization
eventkit events authorize

# List calendars
eventkit events calendars

# List today's events
eventkit events list --today

# List next 14 days
eventkit events list --days 14

# List with full details
eventkit events list --all

# Create an event
eventkit events add "Team Meeting" \
    --start "2024-12-20 14:00" \
    --duration 60 \
    --location "Conference Room" \
    --notes "Q4 Planning"

# Create all-day event
eventkit events add "Company Holiday" \
    --start "2024-12-25" \
    --all-day

# Show event details
eventkit events show <id>

# Delete an event
eventkit events delete <id> --force

Platform Support

This library only works on macOS. It requires:

macOS 10.14 (Mojave) or later
Rust 1.70 or later

Privacy Permissions

Your application needs to request permission to access Calendar and/or Reminders data. Add these keys to your Info.plist:

<!-- For Reminders access -->
<key>NSRemindersUsageDescription</key>
<string>This app needs access to your reminders to help you manage tasks.</string>

<!-- For Calendar access (macOS 14+) -->
<key>NSCalendarsFullAccessUsageDescription</key>
<string>This app needs access to your calendar to manage events.</string>

<!-- For Calendar access (older macOS) -->
<key>NSCalendarsUsageDescription</key>
<string>This app needs access to your calendar to manage events.</string>

API Reference

RemindersManager

Method	Description
`new()`	Create a new manager
`authorization_status()`	Check current auth status
`request_access()`	Request reminders permission
`list_calendars()`	List all reminder lists
`fetch_all_reminders()`	Fetch all reminders
`fetch_incomplete_reminders()`	Fetch incomplete reminders
`fetch_reminders(calendars)`	Fetch from specific lists
`create_reminder(...)`	Create a new reminder
`update_reminder(...)`	Update an existing reminder
`complete_reminder(id)`	Mark as complete
`uncomplete_reminder(id)`	Mark as incomplete
`delete_reminder(id)`	Delete a reminder

EventsManager

Method	Description
`new()`	Create a new manager
`authorization_status()`	Check current auth status
`request_access()`	Request calendar permission
`list_calendars()`	List all calendars
`fetch_today_events()`	Fetch today's events
`fetch_upcoming_events(days)`	Fetch next N days
`fetch_events(start, end, calendars)`	Fetch in date range
`create_event(...)`	Create a new event
`update_event(...)`	Update an existing event
`delete_event(id)`	Delete an event

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

Built with objc2 for Objective-C interop
Inspired by the need for native Rust access to macOS productivity apps

eventkit-rs 0.1.1