AirMCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ICONNECT_FULL | No | Enable all modules (ignores preset). | false |
| GEMINI_API_KEY | No | Google Gemini API key for higher-quality embeddings (optional). | |
| ICONNECT_DISABLE_MUSIC | No | Example of disabling a specific module. Replace 'MUSIC' with the module name (e.g., ICONNECT_DISABLE_MESSAGES=true). | |
| ICONNECT_INCLUDE_SHARED | No | Include shared notes/folders. | false |
| ICONNECT_ALLOW_SEND_MAIL | No | Allow sending emails. | true |
| ICONNECT_ALLOW_SEND_MESSAGES | No | Allow sending iMessages. | true |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_notesA | List all notes with title, folder, and dates. Optionally filter by folder name. Supports pagination via limit/offset. |
| search_notesA | Search notes by keyword in title and body. Returns matching notes with a 200-char preview. |
| read_noteA | Read the full content of a specific note by its ID. Returns HTML body and plaintext. |
| list_remindersA | List reminders. Optionally filter by list name and/or completion status. Supports pagination via limit/offset. |
| list_eventsA | List events within a date range. Requires startDate and endDate (ISO 8601). Optionally filter by calendar name. Supports limit/offset pagination. |
| today_eventsA | Get all calendar events for today. |
| list_directoryA | List files and folders in a directory with metadata (kind, size, modification date). |
| get_clipboardA | Read the current text content of the system clipboard. |
| set_clipboardA | Write text to the system clipboard, replacing its current content. |
| list_shortcutsA | List all available Siri Shortcuts on this Mac. |
| run_shortcutA | Run a Siri Shortcut by name. Optionally provide text input. Returns the shortcut's output. Note: shortcuts may trigger UI prompts or perform system actions. |
| get_current_weatherA | Get current weather conditions for a location using coordinates. |
| get_daily_forecastB | Get daily weather forecast for a location. |
| list_profilesA | List AirMCP runtime profiles. Profiles choose which modules load; toolExposure chooses how much of that surface appears in tools/list. |
| profile_statusA | Show the active AirMCP profile, module set, tool exposure mode, exposed tool count, and total registered tool count. |
| start_tool_sessionA | Create a short-lived allowlist for discover_tools and run_tool. Use this to keep a task scoped to the tools it actually needs. |
| tool_session_statusA | Inspect one active tool session by id without listing other clients' sessions. |
| end_tool_sessionA | End a tool session before its TTL expires. |
| run_toolA | Run an AirMCP tool by name with JSON arguments. Use discover_tools first when the tool is not visible in tools/list. |
| discover_toolsA | Search available tools by keyword. Returns matching tools with descriptions. |
| suggest_next_toolsA | Based on your usage patterns, suggest which tools typically follow a given tool. Learns from how you use AirMCP over time. |
| proactive_contextA | Get contextually relevant tool and workflow suggestions based on time of day, day of week, and your usage patterns. |
| get_workflowB | Retrieve a registered MCP prompt by name and return its workflow instructions as text. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| organize-notes | |
| find-duplicates | |
| notes-weekly-review | Summarize notes from the past week and suggest organization actions. |
| organize-reminders | |
| daily-review | Review today's due reminders and suggest priorities. |
| schedule-review | |
| meeting-prep | |
| shortcut-automation | |
| shortcut-discovery | |
| shortcut-troubleshooting | |
| meeting-notes-to-reminders | |
| weekly-digest | |
| event-follow-up | |
| daily-briefing | Comprehensive daily briefing with today's events, due reminders, and recent notes. |
| research-with-safari | |
| focus-session | |
| file-organizer | |
| dev-session | |
| debug-loop | |
| screen-capture-flow | |
| app-release-prep | |
| idea-to-task | |
| build-log | |
| inbox-zero | Professional email triage: scan, categorize, draft replies, create follow-ups, archive. |
| travel-planner | |
| content-curator | |
| morning-brief | Comprehensive morning briefing: calendar, reminders, email, notes, music, system status. |
| project-kickoff | |
| weekly-review | |
| favorites-digest | Pulls the user's starred photos and drops the metadata into a note — a lightweight "recent highlights" journal. Demonstrates `loop` combined with a terminal `create_note` step that consolidates the loop results. The loop iterates inside `favorites` with `on_error: continue` so a single unreadable asset doesn't truncate the digest. |
| meeting-action-items | Get today's events and recent notes to extract action items and create reminders. |
| morning-briefing | Today's schedule, unread mail count, and due reminders — your daily overview. |
| weekly-digest-note | Gathers a week-in-review snapshot in parallel (upcoming events, open reminders, recent notes, unread mail), asks Apple Intelligence to summarise each track, and drafts a single combined note. Showcases parallel fan-out plus `on_error: continue` — the note still gets written even if summarisation fails for one or two tracks (e.g. Foundation Models unavailable on an Intel Mac). |
| skills-weekly-review | Pulls a structured week-in-review in a single pass: upcoming calendar, open reminders, recent notes, mail backlog, and a health snapshot — all gathered in parallel, with a conditional deep-dive when reminders are backlogged. Shows off the Skills DSL's parallel + conditional features. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| recent-notes | 10 most recently modified Apple Notes |
| today-events | Today's Apple Calendar events, sorted by start time |
| upcoming-events | Upcoming Apple Calendar events for the next 7 days |
| due-reminders | Apple Reminders that are currently due or overdue |
| today-reminders | Apple Reminders due today (incomplete only) |
| clipboard | Current macOS clipboard contents |
| context-snapshot | Unified context from all enabled Apple apps — calendar, reminders, notes, mail, music, system — in a single read. Default depth: brief (~500 tokens). Use context://snapshot/{depth} for standard or full. |
| Calendar Week View | Interactive calendar week grid |
| Timeline (Today) | Interactive day-axis timeline fusing calendar events and due reminders |
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/heznpc/AirMCP'
If you have feedback or need assistance with the MCP directory API, please join our Discord server