MCP server for the entire Apple ecosystem — 123 tools across 14 modules. macOS only.
$ brew install node$ npx airmcp initPlease install the `iconnect` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Node.js** — Install Node.js (e.g., via Homebrew on macOS) Run: `brew install node`
Optional prerequisites:
- Run init wizard — Run the interactive setup wizard to configure modules and macOS permissions Run: `npx airmcp init`
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","airmcp"]
- optional environment variables:
- `AIRMCP_INCLUDE_SHARED`: Include shared notes/folders (example: `false`)
- `AIRMCP_ALLOW_SEND_MESSAGES`: Allow sending iMessages (opt-in) (example: `false`)
- `AIRMCP_ALLOW_SEND_MAIL`: Allow sending emails (opt-in) (example: `false`)
- `AIRMCP_FULL`: Enable all modules (ignores preset) (example: `false`)
- `GEMINI_API_KEY`: Google Gemini API key for cloud embeddings (example: `<your-gemini-api-key>`)
- `AIRMCP_EMBEDDING_PROVIDER`: Force embedding provider: gemini|swift|hybrid|none
- `AIRMCP_HTTP_TOKEN`: Bearer token for HTTP mode authentication
Note: macOS automation MCP server (airmcp). Default preset ships 5 core modules; --full enables 27. Also supports HTTP transport via --http (port 3847) with OAuth 2.1 + PKCE.
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.An MCP Server for computer-use in Windows OS