AirMCP Server

AirMCP

MCP server for the entire Apple ecosystem — Notes, Reminders, Calendar, Contacts, Mail, Messages, Music, Finder, Safari, System, Photos, Shortcuts, Apple Intelligence, TV, Screen Capture, Maps, Podcasts, Weather, Pages, Numbers, Keynote, Location, and Bluetooth. Connect any AI to your Mac.

Available in multiple languages at the project landing page.

Features

• 262 tools (25 modules) — Apple app CRUD + system control + Apple Intelligence + UI Automation + Screen Capture + Maps + Podcasts + Weather + iWork (Pages/Numbers/Keynote) + Google Workspace + dynamic shortcuts
• 32 prompts — per-app workflows (notes, calendar, reminders, shortcuts) + cross-module + developer workflows + YAML skills
• 11 MCP resources — Notes, Calendar, Reminders, Music, Mail, System live data URIs
• JXA + Swift bridge — JXA for basic automation, EventKit/PhotoKit for advanced features
• Recurring events/reminders — EventKit recurrence rules (macOS 26+ Swift bridge)
• Photo import/delete — PhotoKit photo management (macOS 26+ Swift bridge)
• Apple Intelligence — On-device summarize, rewrite, proofread (macOS 26+)
• Native menubar app — SwiftUI companion with onboarding wizard, auto-start, log viewer, update notifications, permission setup
• One-click setup — setup_permissions tool or menubar app to request all macOS permissions at once
• Dual transport — stdio (default, safe local) + HTTP/SSE (--http) for remote agents and registries
• Safety annotations — readOnly/destructive hints on all tools

Get Started (2 minutes)

1. Install Node.js

If you don't have Node.js, install it first:

# Using Homebrew (recommended)
brew install node

# Or download from https://nodejs.org (LTS version)

2. Run the Setup Wizard

npx airmcp init

This will:

• Let you choose which Apple apps to connect (Notes, Calendar, Reminders, etc.)
• Automatically configure your MCP client
• Save your preferences to ~/.config/airmcp/config.json

3. Restart Your MCP Client

That's it! Your AI can now read your notes, manage reminders, check your calendar, and more.

Troubleshooting

npx airmcp doctor

Checks Node.js version, config files, MCP client setup, macOS permissions, and module status — all in one command.

Try It — Talk to Your Mac

Once connected, just ask your AI in natural language. Here are some things you can try:

Everyday

• "Read my latest notes and summarize them"
• "What's on my calendar today?"
• "Show me overdue reminders and reschedule them to tomorrow"
• "Play some jazz on Apple Music"

Productivity

• "Draft a meeting agenda in Notes, then create calendar events for each topic"
• "Find all emails from Alex about the project and create reminders for action items"
• "Search my contacts for everyone at Acme Corp"

System Control

• "Turn on dark mode, set volume to 50%, and lower brightness"
• "Take a screenshot and save it to my Desktop"
• "What apps are running right now? Quit anything I'm not using"

Research & Web

• "Open the Apple developer docs in Safari and summarize the page"
• "Search my Safari tabs for that article I was reading about Swift"

Power User

• "Scan nearby Bluetooth devices"
• "Get my current GPS coordinates and show the weather here"
• "Record my screen for 10 seconds"
• "Run my 'Morning Routine' shortcut"

Cross-App Workflows

• "Check today's meetings, find related notes, and create a prep checklist in Reminders"
• "Search my files for the Q1 report, read it, and draft a summary email to the team"

These are just starting points — with 262 tools across 25 Apple apps, the combinations are endless.

Client Setup

Works with any MCP-compatible client. Examples:

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "airmcp": {
      "command": "npx",
      "args": ["-y", "airmcp"]
    }
  }
}

Claude Code

claude mcp add airmcp -- npx -y airmcp

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "airmcp": {
      "command": "npx",
      "args": ["-y", "airmcp"]
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "airmcp": {
      "command": "npx",
      "args": ["-y", "airmcp"]