iconnect-mcp
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. |
| search_notesA | Search notes by keyword in title and body. |
| read_noteA | Read the full content of a specific note by its ID. |
| create_noteA | Create a new note with HTML body. |
| update_noteA | Replace the entire body of an existing note. |
| delete_noteB | Delete a note by ID. |
| list_foldersA | List all folders across all accounts with note counts. |
| create_folderC | Create a new folder. |
| move_noteB | Move a note to a different folder. |
| scan_notesA | Bulk scan notes returning metadata and a text preview for each. |
| compare_notesA | Retrieve full plaintext content of 2-5 notes at once for comparison. |
| bulk_move_notesB | Move multiple notes to a target folder at once. |
| list_reminder_listsA | List all reminder lists with reminder counts. |
| list_remindersB | List reminders. |
| read_reminderA | Read the full details of a specific reminder by ID. |
| create_reminderB | Create a new reminder. |
| update_reminderC | Update reminder properties. |
| complete_reminderA | Mark a reminder as completed or un-complete it. |
| delete_reminderA | Delete a reminder by ID. |
| search_remindersA | Search reminders by keyword in name or body across all lists (case-insensitive). |
| create_reminder_listA | Create a new reminder list. |
| delete_reminder_listA | Delete a reminder list by name. |
| create_recurring_reminderB | Create a recurring reminder via EventKit. |
| list_calendarsA | List all calendars with name, color, and writable status. |
| list_eventsA | List events within a date range. |
| read_eventA | Read full details of a calendar event by ID. |
| create_eventB | Create a new calendar event. |
| update_eventB | Update event properties. |
| delete_eventA | Delete a calendar event by ID. |
| search_eventsA | Search events by keyword in title or description within a date range. |
| get_upcoming_eventsA | Get the next N upcoming events from now (searches up to 30 days ahead). |
| today_eventsA | Get all calendar events for today. |
| create_recurring_eventB | Create a recurring calendar event via EventKit. |
| search_filesB | Search files using Spotlight (mdfind). |
| get_file_infoA | Get detailed file information including size, dates, kind, and tags. |
| set_file_tagsA | Set Finder tags on a file. |
| recent_filesA | Find recently modified files in a folder using Spotlight. |
| list_directoryB | List files and folders in a directory with metadata (kind, size, modification... |
| move_fileA | Move or rename a file or folder to a new location. |
| trash_fileA | Move a file or folder to the Trash using Finder. |
| create_directoryB | Create a new directory (and intermediate directories if needed). |
| get_clipboardA | Read the current text content of the system clipboard. |
| set_clipboardA | Write text to the system clipboard, replacing its current content. |
| get_volumeA | Get the current system output volume level and mute state. |
| set_volumeA | Set the system output volume (0-100) and/or mute state. |
| toggle_dark_modeA | Toggle macOS appearance between dark mode and light mode. |
| get_frontmost_appA | Get the name, bundle identifier, and PID of the currently active (frontmost) ... |
| list_running_appsA | List all running applications with name, bundle identifier, PID, and visibility. |
| get_screen_infoB | Get display information including resolution, pixel dimensions, and Retina st... |
| show_notificationA | Display a macOS system notification with optional title, subtitle, and sound. |
| capture_screenshotC | Take a screenshot and save to the specified path. |
| get_wifi_statusA | Get the current WiFi status including connected network name, signal strength... |
| toggle_wifiB | Turn WiFi on or off. |
| list_bluetooth_devicesA | List paired Bluetooth devices with their connection status. |
| get_battery_statusA | Get battery percentage, charging state, power source, and estimated time rema... |
| get_brightnessA | Get the current display brightness level. |
| set_brightnessB | Set the display brightness level. |
| toggle_focus_modeA | Toggle Do Not Disturb (Focus mode) on or off. |
| system_sleepA | Put the Mac to sleep. |
| prevent_sleepA | Prevent the Mac from sleeping for a specified duration using caffeinate. |
| system_powerA | Shutdown or restart the Mac. |
| launch_appA | Launch an application by name. |
| quit_appA | Quit a running application by name. |
| is_app_runningA | Check whether an application is currently running. |
| list_all_windowsA | List windows across all running applications with title, size, position, app ... |
| move_windowA | Move a window to a specific position on screen. |
| resize_windowB | Resize a window to specific dimensions. |
| minimize_windowA | Minimize or restore a window. |
| list_shortcutsA | List all available Siri Shortcuts on this Mac. |
| run_shortcutB | Run a Siri Shortcut by name. |
| search_shortcutsA | Search Siri Shortcuts by name keyword. |
| get_shortcut_detailA | Get details about a Siri Shortcut including its actions. |
| create_shortcutC | Create a new Siri Shortcut by name. |
| delete_shortcutA | Delete a Siri Shortcut by name. |
| export_shortcutB | Export a Siri Shortcut to a .shortcut file. |
| import_shortcutA | Import a .shortcut file into Siri Shortcuts. |
| duplicate_shortcutB | Duplicate an existing Siri Shortcut. |
| edit_shortcutA | Open a Siri Shortcut in the Shortcuts app for manual editing. |
| get_current_weatherA | Get current weather conditions for a location using coordinates. |
| get_daily_forecastB | Get daily weather forecast for a location. |
| get_hourly_forecastC | Get hourly weather forecast for a location. |
| summarize_contextC | Collect context from all enabled Apple apps and ask the client's LLM to produ... |
| local_llm_generateA | Generate text using a local Ollama model. |
| local_llm_statusA | Check if a local Ollama LLM is available and list installed models. |
| semantic_indexC | Index data from enabled Apple apps (Notes, Calendar, Reminders, Mail, Photos,... |
| semantic_searchB | Search across Apple app data by meaning, not just keywords. |
| find_relatedC | Given a note, event, reminder, or email ID, find semantically related items a... |
| spotlight_syncB | Push semantically indexed data to macOS Core Spotlight, making it discoverabl... |
| semantic_clearB | Delete all indexed data from the local vector store AND remove corresponding ... |
| spotlight_clearC | Remove all AirMCP entries from macOS Spotlight without clearing the local vec... |
| semantic_statusA | Show the current state of the semantic vector index -- total entries, breakdo... |
| setup_permissionsA | Trigger macOS permission prompts for all Apple apps used by AirMCP. |
| skill_calendar-alertA | [Skill] Automatically fetches today's events when the calendar is modified. |
| skill_clipboard-url-to-readingC | [Skill] Listens for clipboard changes and, when a URL is on the pasteboard, p... |
| skill_daily-journalC | [Skill] Captures today's events + open reminders, summarises them on-device, ... |
| skill_evening-winddownA | [Skill] Fires when the screen is locked — drafts a short day-in-review note c... |
| skill_focus-block-plannerC | [Skill] Walks today's open reminders and drops a calendar time-block for each... |
| skill_focus-guardianD | [Skill] Auto-snapshots today's events and open reminders whenever the system ... |
| skill_inbox-triageA | [Skill] Check unread mail count and list recent messages for triage. |
| skill_project-digestC | [Skill] Semantic-search the user's indexed Apple data for a topic, then loop ... |
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
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