MIT License Free & Open Source macOS Native 5 MCP Tools

Your Mac,
Your Assistant

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

Get Started View 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:  sarah.chen@company.com
  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 8 Reminder 11 Contact 7 Mail 10 System 4

Calendar

list events get search create update delete batch_create

Reminder

lists items get search create complete update delete batch_create batch_complete batch_delete

Contact

groups list search get create update delete

Mail

accounts mailboxes messages get search update move delete batch_update batch_delete

System

status authorize config_show config_init

Quick Start

Three ways to get started — pick your preferred setup

1
Claude Code Recommended 
# Install the plugin
claude plugin marketplace add \
  omarshahine/Apple-PIM-Agent-Plugin
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
OpenClaw npm 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 CLI Manual Setup 
# Clone and build
git clone
 https://github.com/omarshahine/Apple-PIM-Agent-Plugin.git
cd Apple-PIM-Agent-Plugin
./setup.sh --install


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