---
title: AirMCP Documentation
description: More than Siri. Open to every agent. The MCP server that connects your Apple ecosystem to any AI client — 29 modules, 272 tools.
template: splash
hero:
  tagline: More than Siri. Open to every agent. The MCP server that connects your Apple ecosystem to any AI client — 29 modules, 272 tools, from Notes to Health.
  actions:
    - text: Get Started
      link: /getting-started/installation/
      icon: right-arrow
      variant: primary
    - text: View on GitHub
      link: https://github.com/heznpc/AirMCP
      icon: external
---

import { Card, CardGrid } from '@astrojs/starlight/components';

## What is AirMCP?

AirMCP is a [Model Context Protocol](https://modelcontextprotocol.io/) server that exposes the Apple ecosystem to any MCP-compatible AI client. It bridges LLMs like Claude, GPT, and Gemini to native macOS applications through JXA (JavaScript for Automation), a Swift bridge, and direct system APIs — so the AI reads, writes, and acts on top of your Apple data. AirMCP is the connector; the AI is the thinker.

<CardGrid stagger>
  <Card title="27 Modules" icon="puzzle">
    Notes, Reminders, Calendar, Contacts, Mail, Messages, Music, Finder, Safari, System, Photos, Shortcuts, Intelligence, TV, UI, Screen, Maps, Podcasts, Weather, Pages, Numbers, Keynote, Location, Bluetooth, Google, Speech, and Health.
  </Card>
  <Card title="262 Tools" icon="setting">
    Read, create, update, and delete across every supported app. Full CRUD for Notes, Reminders, Calendar, and Contacts. Read-only access for Photos, Music, and more.
  </Card>
  <Card title="Semantic Search" icon="magnifier">
    On-device vector embeddings via the Swift bridge (NLContextualEmbedding) or Gemini API. Search notes and reminders by meaning, not just keywords.
  </Card>
  <Card title="Works Everywhere" icon="laptop">
    Compatible with Claude Desktop, Claude Code, Cursor, Windsurf, Cline, and any MCP-compliant client. Supports both stdio and HTTP transports.
  </Card>
</CardGrid>

## Quick Start

```bash
npx airmcp init
```

The interactive setup wizard will guide you through module selection and MCP client configuration. See the [Installation guide](/getting-started/installation/) for detailed instructions.
