Airmcp

Name: Airmcp
Author: heznpc

by heznpccommunityv2.12.0

AirMCP is a macOS MCP server that exposes Apple-native automation and app-control capabilities through 272 tools across 29 modules, including Notes, Calendar, Reminders, Mail, Music, iWork, Maps, Weather, Apple Intelligence, and Google Workspace. It includes safety and governance features such as HITL approval, audit logging, rate limiting, OAuth 2.1 scope gating, and optional Swift-backed integrations for Apple frameworks.

From the registry: Apple-native MCP server - 272 tools across 29 modules. HITL, audit log, rate limits. macOS only.

GitHub Repository Website

Install & configure

Prerequisites

required
Install Node.js
Node.js is required to run AirMCP via npx.
```
$ brew install node
```
https://nodejs.org/
required
Use macOS
AirMCP requires macOS to run. Most tools work on macOS 14+ with no extra setup.
optional
Optional Swift bridge build
Swift-backed tools require the optional Swift bridge. Without it, those tools return a clear 'Swift bridge not found' error while other tools continue working.
```
$ npm run swift-build
```

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `airmcp` MCP server into my current AI client (that's you).

Required prerequisites (do these first if not already done):
- **Install Node.js** — Node.js is required to run AirMCP via npx. Run: `brew install node` (https://nodejs.org/)
- **Use macOS** — AirMCP requires macOS to run. Most tools work on macOS 14+ with no extra setup.

Optional prerequisites:
- Optional Swift bridge build — Swift-backed tools require the optional Swift bridge. Without it, those tools return a clear 'Swift bridge not found' error while other tools continue working. Run: `npm run swift-build`

Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","airmcp"]

Note: Default transport is stdio via `npx -y airmcp`. The default invocation loads a curated starter module set; `--full` or `AIRMCP_FULL=true` enables all modules. AirMCP also supports HTTP/SSE mode via `npx airmcp --http --port 3847`, but the simplest portable install path in the README is stdio.

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Note: Default transport is stdio via `npx -y airmcp`. The default invocation loads a curated starter module set; `--full` or `AIRMCP_FULL=true` enables all modules. AirMCP also supports HTTP/SSE mode via `npx airmcp --http --port 3847`, but the simplest portable install path in the README is stdio.