Airmcp

Name: Airmcp
Author: heznpc

@heznpc

Repository

About Airmcp

AirMCP connects AI to the entire Apple ecosystem on macOS. 253 tools across

#apple #macos #automation #notes #calendar #reminders #contacts #mail #messages #music #finder #safari #system #photos #shortcuts #apple-intelligence #productivity #mcp

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is AirMCP?

AirMCP is an MCP server for the entire Apple ecosystem on macOS, providing 253 tools across 25 modules (Notes, Reminders, Calendar, Contacts, Mail, Messages, Music, Finder, Safari, System, Photos, Shortcuts, Apple Intelligence, TV, Screen Capture, Maps, Podcasts, Weather, Pages, Numbers, Keynote, Location, Bluetooth, and more). It’s designed for AI agents and users who want to connect any MCP-compatible AI to their Mac for read, write, and system control operations.

How to use AirMCP?

Install Node.js (v18+), then run npx airmcp init to run the setup wizard, which lets you choose which Apple apps to connect and auto-configures your MCP client. After restarting the client, the AI can interact with Apple apps. Alternatively, use npx -y airmcp as the server command in any MCP-compatible client (Claude Desktop, Claude Code, Cursor, Windsurf, etc.). For remote access, run with --http --port 3847.

Key features of AirMCP

253 tools across 25 Apple app modules
32 pre‑built prompts for app‑specific workflows
11 MCP resources exposing live data from Notes, Calendar, etc.
JXA + Swift bridge for basic and advanced automation
Native menubar app with onboarding wizard and log viewer
Dual transport: stdio (default) and HTTP/SSE (--http)
Safety annotations (readOnly/destructive) on all tools

Use cases of AirMCP

Read, create, and manage Notes, Reminders, Calendar events, Contacts, and Mail
Control system settings (dark mode, volume, brightness) and quit apps
Search files, take screenshots, record screen, and scan Bluetooth devices
Interact with Safari tabs, Apple Music playback, and Apple Intelligence (summarize, rewrite, proofread)
Run cross‑app workflows like “check meetings, find notes, create reminders”

FAQ from AirMCP

What are the system requirements for AirMCP?

Node.js 18 or later is required. Some advanced features (Apple Intelligence, recurring events/reminders, PhotoKit photo import/delete) require macOS 26+.

How do I install and configure AirMCP?

Run npx airmcp init to start the interactive setup wizard, which configures your MCP client automatically. Alternatively, manually add npx -y airmcp as the server command in your client’s MCP config file.

Can AirMCP run remotely or on a headless Mac?

Yes. Use npx airmcp --http --port 3847 to start in HTTP/SSE mode, enabling remote agents, registries, and multi‑client setups (e.g., an “always‑on AI hub” on a Mac Mini).

Does AirMCP need macOS permissions to access Apple apps?

Yes. Use the setup_permissions tool or the native menubar app to request all required macOS permissions at once.

Which MCP clients are supported?

Any client that supports stdio transport can use AirMCP. Explicit configuration examples are provided for Claude Desktop, Claude Code, Cursor, and Windsurf.