Skip to main content
Glama
heznpc

AirMCP

by heznpc
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Local

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

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

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. 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.

list_module_packsA

List DLC-like AirMCP module packs and whether each pack is available in the current runtime configuration.

install_module_packA

Install, repair, update, or uninstall one AirMCP add-on package after explicit user confirmation. Use dryRun first to preview the npm command.

profile_statusA

Show the active AirMCP profile, module set, tool exposure mode, exposed tool count, and total registered tool count.

workflow_readinessA

Explain whether curated AirMCP workflows are ready in the active runtime, including missing modules, add-ons, tools, and write opt-ins.

preview_actionA

Dry-run governance preview of a tool call WITHOUT executing it.

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.

describe_toolA

Fetch the full description for one registered AirMCP tool after discover_tools returns a compact match.

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

Rank the tools that most often followed a given tool in this install's local call history.

proactive_contextA

Return tool/workflow candidates ranked by a deterministic heuristic over the current time of day, day of week, and this install's tallied usage counts.

get_workflowB

Retrieve a registered MCP prompt by name and return its workflow instructions as text.

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
trust-attestationLive governance/trust attestation: whole-chain audit verification (tamper-evident), HITL approval level, rate-limit budget + emergency-stop state, and audit key grade. The `governed` boolean is true whenever the chain verifies and is not halted; the honest key-grade-aware verdict is `assurance` (operator-attested vs tamper-evident) — any one-line trust readout must use `assurance`, not bare `governed`. First-party server attestation; read it to verify the 'governed runtime, not an agent' claim before widening tool access.
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