npx airmcp init → connected

AirMCP

AirMCP

Better Siri, powered by open source.

Pull action items from last week's meeting notes, drop them into Reminders, get pinged when they're done.

29
Modules
269
Tools
32
Prompts
8
Resources

One server. Every Apple app.

Native. Fast. Built on AppleScript and Apple frameworks.

Notes

Create, search, and manage Apple Notes.

12 tools

Reminders

Manage lists, due dates, and priorities.

11 tools

Calendar

Events, schedules, and availability.

10 tools

Contacts

Search, create, and update contacts.

10 tools

Mail

Read, compose, and manage email.

11 tools

Messages

Read and send iMessages.

6 tools

Music

Playback, playlists, and library control.

13 tools

Photos

Albums, search, and metadata.

9 tools

TV

Browse and control Apple TV app.

6 tools

Podcasts

Browse shows and control playback.

6 tools

System

Dark mode, volume, WiFi, Bluetooth, and more.

27 tools

Finder

Browse, move, and organize files.

8 tools

Safari

Tabs, reading list, and page content.

12 tools

Screen

Screenshot and screen capture.

5 tools

Maps

Search locations and get directions.

8 tools

Location

GPS coordinates and location services.

2 tools

Bluetooth

Scan, connect, and manage BLE devices.

4 tools

Shortcuts

Run and manage Shortcuts automations.

11 tools
macOS 26+

Intelligence

Apple Intelligence writing tools and image generation.

8 tools

UI Automation

Accessibility-based UI inspection and control.

6 tools

Up and running in minutes.

1

Install

Interactive setup wizard. Choose your modules.

npx airmcp init
2

Configure

Add one JSON block to any MCP client.

3

Use

AI reads notes, manages calendar, sends mail, and more.

mcp-config.json
{
  "mcpServers": {
    "airmcp": {
      "command": "npx",
      "args": ["-y", "airmcp"]
    }
  }
}

Add this to Claude Code, Codex, or any MCP client.

Just ask. In plain language.

Click a prompt to see AirMCP in action.

AirMCP — Terminal
Click a prompt below to start...

269 tools. Endless combinations.

Five things your Mac couldn't do until now.

Every item ships as a built-in skill or tool. Install AirMCP, say the words, done.

Mail Reminders loop

Turn newsletter inbox into a to-do list

"Find every newsletter from this month and create a follow-up reminder for each." AirMCP's sender-to-tasks skill loops through 10+ matches with per-item retry and HITL approval. Siri runs one command at a time.

Calendar Reminders Notes trigger

A journal that writes itself when you walk away

Lock your screen — the evening-winddown skill triggers on screen_locked, gathers today's events + open reminders in parallel, summarises them on-device, and drops a dated note. Zero Shortcuts wiring.

Calendar Reminders MCP App

Today's events + due reminders on one timeline

One tool call — timeline_today — renders an interactive 6am→10pm axis that fuses Calendar and Reminders into a single view with an Unscheduled rail on the right. No more flipping between two apps.

Safari Pasteboard trigger

Copy a URL, land in Reading List — automatically

The clipboard-url-to-reading skill fires on pasteboard_changed, validates the value is a URL, and queues it in Safari's Reading List. Plain text on the clipboard? It silently skips. No macro recorder required.

Audit Rate limit Kill switch

Ask your Mac what the AI did this week

Every tool call lands in an on-device JSONL audit log with PII-scrubbed args. Run audit_summary for a weekly report (total calls, error rate, top tools), or pull the raw trail via audit_log. And if an agent loop goes rogue, touch ~/.config/airmcp/emergency-stop blocks every destructive tool in under a second — no restart needed.

Prompts that connect everything.

Pre-built prompts that orchestrate multiple Apple apps together.

Calendar Reminders Notes

daily-briefing

Summarize today's events, due reminders, and recent notes.

Calendar Notes Reminders

weekly-digest

Review the past week and plan ahead.

Calendar Notes

meeting-prep

Pull event details, search notes, build context.

Safari Notes

research-with-safari

Research topics using Safari, save findings to Notes.

Calendar Reminders Music

focus-session

Check conflicts, prioritize reminders, manage music.

Finder Notes

file-organizer

Scan a folder, categorize, summarize in Notes.

Calendar Notes Reminders

event-follow-up

After a meeting, create follow-up notes and action items automatically.

The most complete Apple MCP server.

See how AirMCP compares to the alternatives.

1

269 tools across 29 modules

Others offer 10-15 tools and stop updating. AirMCP covers every major Apple app — and keeps growing.

2

Security by default

Human-in-the-loop confirmation, audit logging, and input validation. No silent writes.

3

Works with any MCP client

Claude Code, Codex, Cursor, Windsurf, and every client that speaks the MCP protocol.

4

Native Swift bridge

EventKit, PhotoKit, HealthKit, and CoreLocation — real framework access, not just AppleScript.

5

Actively maintained

Regular releases, community-driven roadmap, and responsive issue triage.

Start in seconds.

Install globally, or run directly with npx.

# Install globally
$ npm install -g airmcp

# Or run directly
$ npx airmcp

Requires Node.js 18+ and macOS. Works with Claude Code, Codex, and any MCP client.