Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
ICONNECT_FULLNoEnable all modules (ignores preset).false
GEMINI_API_KEYNoGoogle Gemini API key for higher-quality embeddings (optional).
ICONNECT_DISABLE_MUSICNoExample of disabling a specific module. Replace 'MUSIC' with the module name (e.g., ICONNECT_DISABLE_MESSAGES=true).
ICONNECT_INCLUDE_SHAREDNoInclude shared notes/folders.false
ICONNECT_ALLOW_SEND_MAILNoAllow sending emails.true
ICONNECT_ALLOW_SEND_MESSAGESNoAllow sending iMessages.true

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription
organize-notes
find-duplicates
notes-weekly-reviewSummarize notes from the past week and suggest organization actions.
organize-reminders
daily-reviewReview 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-briefingComprehensive 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-zeroProfessional email triage: scan, categorize, draft replies, create follow-ups, archive.
travel-planner
content-curator
morning-briefComprehensive morning briefing: calendar, reminders, email, notes, music, system status.
project-kickoff
weekly-review
favorites-digestPulls 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-itemsGet today's events and recent notes to extract action items and create reminders.
morning-briefingToday's schedule, unread mail count, and due reminders — your daily overview.
weekly-digest-noteGathers 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-reviewPulls 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

NameDescription
recent-notes10 most recently modified Apple Notes
today-eventsToday's Apple Calendar events, sorted by start time
upcoming-eventsUpcoming Apple Calendar events for the next 7 days
due-remindersApple Reminders that are currently due or overdue
today-remindersApple Reminders due today (incomplete only)
clipboardCurrent macOS clipboard contents
context-snapshotUnified 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 ViewInteractive 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