macOS

Local runtime

HITL

Per-call approval

HMAC

Audit chain

MCP

Any client

Apple platforms

One governed runtime across Apple platforms.

macOS available now · iOS and iPadOS in preview · visionOS and watchOS on the roadmap.

Modules

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

How It Works

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.

Try It

Just ask. In plain language.

Click a prompt to see AirMCP in action.

AirMCP — Terminal

❯ Click a prompt below to start...

One governed runtime across your Apple workspace.

Beyond Siri

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.

Workflows

Prompts that connect everything.

Pre-built prompts that orchestrate multiple Apple apps together.

Calendar Reminders Mail Notes

`daily-briefing`

Summarize today's events, due reminders, unread mail, 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.

Why AirMCP?

A governed action layer for Apple apps.

See how AirMCP compares to the alternatives.

1

A connector and control layer

Your MCP client does the reasoning. AirMCP exposes Apple actions through profiles and progressive discovery.

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.

Installation

Choose the path for your client.

The current public paths are a Claude Desktop extension and direct stdio for other MCP clients.

Claude Desktop

Install the .mcpb

Download airmcp-<version>.mcpb, then drag it into Claude Desktop. No app download or npm setup is required.

Open Releases

Codex · Claude Code · Cursor · Windsurf

Connect direct stdio

Use the npm runtime directly when the current release does not include a signed AirMCP.app ZIP.

$ npx airmcp init --no-clients
$ npx airmcp connect-clients --client-runtime direct

AirMCP.app is an additional app-owned runtime only when a release lists a signed AirMCP-<version>.zip. If that asset is absent, do not configure clients to wait for the app runtime.

Direct stdio requires Node.js 20+ and macOS. Client configuration changes remain explicit.