AirMCP

What it does

AirMCP is an MCP app that renders an interactive native menubar companion for macOS, giving AI agents direct control over your entire Apple ecosystem. With 262 tools spanning 27 modules — from Notes, Reminders, and Calendar to Safari, Music, Photos, and Apple Intelligence — it turns your Mac into a context-aware environment that any MCP-compatible AI can read, navigate, and automate. The SwiftUI menubar app provides onboarding, permission setup, log viewing, and one-click configuration.

Key features

• 262 tools across 27 modules — Full CRUD for Notes, Reminders, Calendar, Contacts, Mail, Messages, Music, Finder, Safari, System, Photos, Shortcuts, Maps, Podcasts, Weather, iWork, and more
• Apple Intelligence integration — On-device text summarization, rewriting, proofreading, and structured generation (macOS 26+)
• UI Automation — Click, type, scroll, and query accessibility trees in any macOS app
• Screen Capture — Full screen, window, region, and video recording
• Google Workspace — Gmail, Drive, Sheets, Calendar, Docs, Tasks, and Contacts via CLI bridge
• Semantic Search — Cross-app vector search powered by Apple NLContextualEmbedding or Gemini embeddings
• Dual transport — stdio (default) and HTTP/SSE for remote agents and registries
• Human-in-the-Loop — Configurable approval gates for destructive operations

Installation

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

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

VS Code Copilot: Add to settings.json:

{
  "github.copilot.chat.mcp.servers": {
    "airmcp": {
      "command": "npx",
      "args": ["-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"]
    }
  }
}

Quick setup: Run npx airmcp init for an interactive wizard that configures your preferred modules and MCP client automatically.

Supported hosts

• Claude Desktop
• VS Code Copilot
• Cursor
• Windsurf
• Claude Code (CLI)