Search everything...

Stats

Actions

Available In

apple-pim

Name: apple-pim
Author: omarshahine

By omarshahine

Manage macOS Calendar, Reminders, Contacts, and Mail.app directly from Claude Code — schedule events, create tasks, look up contacts, and triage email using native Apple frameworks (EventKit, Contacts, JXA). Includes permission management and an MCP server for local integration.

JavaScript

Node

automation

npx claudepluginhub omarshahine/apple-pim-agent-plugin --plugin apple-pim

Popularity

Stars

Top 25%

Med: 0·Avg: 285

Installs

Med: 0·Avg: 1

What's Inside

Slash Commands6

Authorize Apple PIM Access

/authorize

Check and request macOS permissions for calendars, reminders, contacts, and Mail.app automation

Calendar Management

/calendars

Manage macOS calendar events - list, search, create, update, delete with batch operations

Configure Apple PIM Access

/configure

Configure which domains, calendars, and reminder lists the plugin can access

Contact Management

/contacts

Manage macOS contacts - list, search, get details, create, update, delete

Mail Management

/mail

Manage macOS Mail.app - list, read, search, send, reply, update flags, move, delete, and verify sender authentication

Agents1

PIM Assistant

/pim-assistant

Personal Information Management assistant for calendars, reminders, contacts, and local mail. Use this agent when: - User mentions scheduling, appointments, meetings, events, or calendar - User mentions reminders, tasks, todos, "remind me", or "don't forget" - User asks about contacts, people, email addresses, phone numbers - User wants to manage their calendar, reminders, or address book - User needs help with time management or task tracking - User wants to check local Mail.app messages, search mail, or triage inbox - User asks about permissions or access to calendars/reminders/contacts/mail <example> user: "Schedule a meeting with the team for next Tuesday at 2pm" assistant: "I'll use the pim-assistant agent to create a calendar event for the team meeting." </example> <example> user: "Remind me to call the dentist tomorrow" assistant: "I'll use the pim-assistant agent to create a reminder for calling the dentist." </example> <example> user: "What's John's email address?" assistant: "I'll use the pim-assistant agent to look up John's contact information." </example> <example> user: "What do I have scheduled for this week?" assistant: "I'll use the pim-assistant agent to show your calendar events for this week." </example> <example> user: "Mark the grocery shopping reminder as done" assistant: "I'll use the pim-assistant agent to complete the grocery shopping reminder." </example> <example> user: "Check my Mail.app inbox for unread messages" assistant: "I'll use the pim-assistant agent to list unread messages from Mail.app." </example> <example> user: "What reminders are overdue?" assistant: "I'll use the pim-assistant agent to show overdue reminders." </example> <example> user: "Mark all those reminders as done" assistant: "I'll use the pim-assistant agent to batch complete the reminders." </example> <example> user: "I'm getting permission errors with my calendar" assistant: "I'll use the pim-assistant agent to check authorization status." </example>

Skills1

apple-pim

/apple-pim

Native macOS personal information management for calendars, reminders, contacts, and local Mail.app. Use when the user wants to schedule meetings, create events, check their calendar, create or complete reminders, look up contacts, find someone's phone number or email, manage tasks and to-do lists, triage local Mail.app messages, or troubleshoot EventKit, Contacts, or Mail.app permissions on macOS.

MCP Servers1

apple-pim

admin

Stats

Version3.8.2

ReleasedMay 31, 2026

LanguageSwift

Stars6

Forks7

MaintenanceExcellent

LicenseMIT

Last CommitJun 11, 2026

AddedFeb 9, 2026

Actions

View on GitHub View README Plugin Marketplace JSON

Own this plugin?

Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).

Available In

apple-pim6 my-plugins3

Safety Signals

Critical

Admin access level

Server config contains admin-level keywords

README

Apple PIM CLI Tools

GitHub: github.com/omarshahine/Apple-PIM-Agent-Plugin

Native macOS integration for Calendar, Reminders, Contacts, and Mail using EventKit, Contacts, and JXA frameworks. Works with Claude Code (via MCP) and OpenClaw (via native tool registration).

Features

Calendar Management: List calendars, create/read/update/delete events, search by date/title, attendee support (add/replace attendees via CalDAV invitation emails)
Reminder Management: List reminder lists, create/complete/update/delete reminders, search
Contact Management: List groups, create/read/update/delete contacts, search by name/email/phone, birthday support (with or without year)
Mail Integration: List accounts/mailboxes, read/search/send/reply/move/delete messages, update flags, attachment support (metadata, save-to-disk, send/reply with attachments), verify sender authentication (via Apple Mail.app + JXA/AppleScript)
Recurrence Rules: Create recurring events and reminders (daily, weekly, monthly, yearly)
Batch Operations: Create multiple events or reminders in a single efficient transaction
Per-Domain Control: Enable or disable entire domains (calendars, reminders, contacts, mail) independently
Multi-Agent Isolation: Per-call config/profile overrides for workspace isolation
Works with Claude Code and OpenClaw: Same Swift CLIs, different integration layers

Prerequisites

macOS 13.0 or later
Swift 5.9 or later (comes with Xcode 15+)
Node.js 18+ (for MCP server or OpenClaw plugin)
Mail.app must be running for mail commands (it is not launched automatically)

Installation

Swift CLI Tools (Required for both platforms)

# Build the Swift CLIs
./setup.sh

# Optional: install to PATH for system-wide access
./setup.sh --install

# Add to your shell profile (if not already there)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

The --install flag creates symlinks in ~/.local/bin/, so rebuilding (swift build -c release) automatically updates the global commands.

Claude Code Plugin

Inside Claude Code, run:

/plugin marketplace add omarshahine/Apple-PIM-Agent-Plugin
/plugin install apple-pim@apple-pim

Then build the Swift CLIs (once, from a shell):

~/.claude/plugins/cache/apple-pim/apple-pim/*/setup.sh

Restart Claude Code to load the MCP server. The pim-assistant agent triggers automatically when you mention scheduling, reminders, contacts, or email.

OpenClaw Plugin

# Install from ClawHub
openclaw plugins install apple-pim-cli

# Or install from npm
npm install -g apple-pim-cli

Under the hood, the plugin spawns native macOS Swift binaries (calendar-cli, reminder-cli, contacts-cli, mail-cli) that interact with EventKit, Contacts, and Mail.app via Apple's frameworks.

Prerequisites: Swift CLIs must be on PATH (run ./setup.sh --install first).

Optionally, configure the binary location if the CLIs are not on PATH:

# In your OpenClaw config:
# plugins.entries.apple-pim-cli.config.binDir = "/path/to/swift/.build/release"

Post-Installation (both platforms)

Grant permissions: On first use, macOS will prompt for Calendar, Reminders, and Contacts access. Grant these permissions in System Settings > Privacy & Security.

Mail.app Automation: For mail features, you also need to grant Automation permission:

System Settings > Privacy & Security > Automation
Allow Terminal (or your IDE) to control Mail.app

Development Installation

git clone https://github.com/omarshahine/Apple-PIM-Agent-Plugin.git
cd Apple-PIM-Agent-Plugin
./setup.sh

Then inside Claude Code, add the local checkout as a marketplace:

/plugin marketplace add /absolute/path/to/Apple-PIM-Agent-Plugin
/plugin install apple-pim@apple-pim

For OpenClaw (loads TypeScript directly, no build step):

openclaw plugins install -l ./openclaw

Configuration

The plugin includes a full access control system (PIMConfig) that lets you restrict which calendars, reminder lists, and domains each agent can see. This is useful for:

Access control — allowlist or blocklist specific calendars and reminder lists
Privacy — hide calendars you don't need the agent to see
Reducing noise — only show relevant reminder lists
Avoiding conflicts — disable mail here if you use a separate email MCP
Multi-agent setups — give each agent a profile with different access
Read-only calendars — let agents see but not modify certain calendars

Interactive Setup (Claude Code)

View full README on GitHub

apple-pim

Popularity

What's Inside

Confidence

README

Apple PIM CLI Tools

Features

Prerequisites

Installation

Swift CLI Tools (Required for both platforms)

Claude Code Plugin

OpenClaw Plugin

Post-Installation (both platforms)

Development Installation

Configuration

Interactive Setup (Claude Code)

Similar Plugins

ui-design

nanobanana

llm-council-plugin

product-management

More by omarshahine

homeclaw

rename-agent

credit-card-benefits

travel-agent

chief-of-staff

Apple PIM CLI Tools

Features

Prerequisites

Installation

Swift CLI Tools (Required for both platforms)

Claude Code Plugin

OpenClaw Plugin

Post-Installation (both platforms)

Development Installation

Configuration

Interactive Setup (Claude Code)

Popularity

Health & Quality

More by omarshahine

homeclaw

rename-agent

credit-card-benefits

travel-agent

chief-of-staff

Similar Plugins

ui-design

nanobanana

llm-council-plugin

product-management

caveman

claude-mem