MIT LicenseFree & Open SourcemacOS Native5 MCP Tools

Your Mac,
Your Assistant

Native macOS integration for Calendar, Reminders, Contacts, and Mail — powered by Swift and the Model Context Protocol.

Get StartedView on GitHub
apple-pim — zsh — 120×48
❯ claude "What's on my calendar today?"

Using apple-pim calendar tool...

Today — Friday, March 14

  09:00  Team Standup           Microsoft Teams
  11:30  Design Review          Conf Room 4A
  14:00  1:1 with Sarah         Office
  16:00  Dentist Appointment    Personal

❯ claude "Remind me to buy flowers for Mom's birthday Saturday"

Using apple-pim reminder tool...
✓ Created reminder in Family
  Due: Saturday, March 16 at 10:00 AM

❯ claude "What's Sarah's email?"

Using apple-pim contact tool...

  Sarah Chen
  Email:  [email protected]
  Phone:  (206) 555-0142
  Title:  Engineering Manager

❯ ▌

Everything You Need

Native macOS PIM integration with 5 MCP tools covering Calendar, Reminders, Contacts, Mail, and system management.

📅

Calendar Management

List calendars, create/read/update/delete events, search by date or title, batch create, and full recurrence rule support.

✅

Reminder Management

List reminder lists, create/complete/update/delete reminders, smart filters (overdue, today, week), and batch operations.

👤

Contact Management

List groups, create/read/update/delete contacts, search by name/email/phone, birthday and relationship support.

📧

Mail Integration

List accounts and mailboxes, read/search/move/delete messages, update flags — all through Mail.app and JXA.

🔒

Per-Domain Control

Enable or disable entire domains independently, allowlist/blocklist calendars and reminder lists. Privacy-first design.

🤖

Multi-Agent Isolation

Per-call config and profile overrides, workspace isolation. Give each agent different PIM access for safe delegation.

How It Works

Three layers, direct system access

💻
AI Assistant
Claude Code, OpenClaw, or CLI
↓
🔌
MCP Server / Plugin
Node.js handlers, schemas
↓
🍎
Swift CLIs
EventKit, Contacts, JXA

Native Swift binaries — no Electron, no web APIs, direct system framework access

40 Actions, 5 Domains

Full coverage of your Mac's built-in PIM apps

Calendar 8Reminder 11Contact 7Mail 10System 4

Calendar

listeventsgetsearchcreateupdatedeletebatch_create

Reminder

listsitemsgetsearchcreatecompleteupdatedeletebatch_createbatch_completebatch_delete

Contact

groupslistsearchgetcreateupdatedelete

Mail

accountsmailboxesmessagesgetsearchupdatemovedeletebatch_updatebatch_delete

System

statusauthorizeconfig_showconfig_init

Quick Start

Three ways to get started — pick your preferred setup

1
Claude CodeRecommended
# Install the plugin
claude plugin marketplace add \
  omarshahine/apple-pim
claude plugin install apple-pim@apple-pim


# Build Swift CLIs
~/.claude/plugins/cache/apple-pim/apple-pim/*/setup.sh


# Restart Claude Code to load the MCP server
2
OpenClawnpm Package
# Prerequisites: Swift CLIs must be on PATH
./setup.sh --install
openclaw plugins install apple-pim-cli


# Works immediately — no build step needed
3
Direct CLIManual Setup
# Clone and build
git clone
 https://github.com/omarshahine/apple-pim.git
cd apple-pim
./setup.sh --install


# Try it out
calendar-cli list
reminder-cli items --filter today
contacts-cli search "John"