# @heznpc/airmcp-spatial

Source: https://glimind.com/server/npm%2F-heznpc%2Fairmcp-spatial
Registry id: `npm/-heznpc/airmcp-spatial`
Status: unknown

## Install

```json
{
  "mcpServers": {
    "heznpc-airmcp-spatial": {
      "command": "npx",
      "args": [
        "-y",
        "@heznpc/airmcp-spatial"
      ]
    }
  }
}
```

Claude Code:

```sh
claude mcp add heznpc-airmcp-spatial -- npx -y @heznpc/airmcp-spatial
```

## Tools (80)

- `add_contact_email`: Add an email address to an existing contact.
- `add_contact_phone`: Add a phone number to an existing contact.
- `ai_agent`: Run a prompt through Apple's on-device Foundation Models with read-only access to AirMCP data
- `ai_chat`: Send a message to an on-device AI session using Apple Foundation Models. Note: each call creates a fresh session — sessionName is for caller-side tracking only,
- `ai_plan_metrics`: Run a sample of planner goals against the on-device Foundation Model and report the aggregate score.
- `ai_status`: Check availability and status of Apple's on-device Foundation Models. Returns whether the model is available, macOS version, and Apple Silicon status.
- `audit_log`: Query the on-device audit log of tool calls. Reads JSONL rows from ~/.airmcp/audit.jsonl (+ rotated siblings)
- `audit_summary`: Aggregate the audit log over a time window — total call count, error rate, the busiest tools, and a
- `connect_bluetooth`: Connect to a BLE device by its UUID. The UUID can be obtained from scan_bluetooth results.
- `create_contact`: Create a new contact with name and optional email, phone, organization.
- `create_directory`: Create a new directory (and intermediate directories if needed).
- `create_event`: Create a new calendar event. Recurring events cannot be created via automation. Attendees cannot be added programmatically.
- `create_recurring_event`: Create a recurring calendar event via EventKit. Supports daily, weekly, monthly, and yearly recurrence with configurable intervals. Requires macOS 26+ Swift bri
- `delete_contact`: Delete a contact by ID. This action is permanent.
- `delete_event`: Delete a calendar event by ID. This action is permanent.
- `disconnect_bluetooth`: Disconnect a BLE device by its UUID.
- `generate_image`: Generate an image from a text description using Apple Intelligence on-device image generation (Image Playground).
- `generate_plan`: Use Apple's on-device Foundation Model to analyze a goal and generate a suggested plan of AirMCP tool calls.
- `generate_structured`: Generate structured JSON output from Apple's on-device Foundation Model with optional schema constraints. Useful for extracting structured data from natural lan
- `generate_text`: Generate text using Apple's on-device Foundation Model with custom system instructions. Runs entirely on-device via Apple Silicon. Requires macOS 26+.
- `get_bluetooth_state`: Check whether Bluetooth is powered on, off, or unauthorized.
- `get_file_info`: Get detailed file information including size, dates, kind, and tags.
- `get_upcoming_events`: Get the next N upcoming events from now (searches up to 30 days ahead). A convenience wrapper that doesn't require date range parameters.
- `gws_calendar_create`: Create an event in Google Calendar.
- `gws_calendar_list`: List upcoming events from Google Calendar.
- `gws_docs_read`: Read the content of a Google Doc by document ID.
- `gws_drive_list`: List files in Google Drive. Supports query filters.
- `gws_drive_read`: Get metadata for a Google Drive file by ID.
- `gws_drive_search`: Full-text search across Google Drive files by content or name.
- `gws_gmail_list`: List recent Gmail messages. Supports query filters (e.g. 'from:alice is:unread').
- `gws_gmail_read`: Read a Gmail message by ID. Returns subject, from, to, date, and body.
- `gws_gmail_send`: Send an email via Gmail. Encodes the message in RFC 2822 format.
- `gws_people_search`: Search contacts in Google People/Contacts.
- `gws_raw`: Execute any Google Workspace CLI command. For advanced use when specific tools don't cover your need.
- `gws_sheets_read`: Read cell values from a Google Sheets spreadsheet.
- `gws_sheets_write`: Write values to a Google Sheets range.
- `gws_status`: Check if Google Workspace CLI (gws) is installed and authenticated.
- `gws_tasks_create`: Create a task in Google Tasks.
- `gws_tasks_list`: List tasks from Google Tasks (default task list).
- `health_authorize`: Request read-only HealthKit authorization. Call this first if other health tools return permission errors.
- `health_heart_rate`: Get average resting heart rate over the last 7 days (bpm) from HealthKit.
- `health_sleep`: Get total sleep hours for a given date (defaults to last night). Only counts actual sleep stages, not time in bed.
- `health_summary`: Get a combined health dashboard: today's steps, 7-day average heart rate, last night's sleep, active energy burned, and exercise minutes. All data is aggregated
- `health_today_steps`: Get aggregated step count for today from HealthKit.
- `keynote_add_slide`: Add a new slide to a Keynote presentation.
- `keynote_close_document`: Close an open Keynote presentation, optionally saving changes.
- `keynote_create_document`: Create a new blank Keynote presentation.
- `keynote_export_pdf`: Export a Keynote presentation to PDF. Will overwrite an existing file at the same path.
- `keynote_get_slide`: Get detailed content of a specific slide including all text items and presenter notes.
- `keynote_list_documents`: List all open Keynote presentations.
- `keynote_list_slides`: List all slides in a Keynote presentation with title, body preview, and presenter notes.
- `keynote_set_presenter_notes`: Set presenter notes on a specific slide.
- `keynote_start_slideshow`: Start playing a Keynote slideshow from a specific slide.
- `list_calendars`: List all calendars with name, color, and writable status.
- `list_contacts`: List contacts with name, primary email, and phone. Supports pagination.
- `list_directory`: List files and folders in a directory with metadata (kind, size, modification date).
- `list_events`: List events within a date range. Requires startDate and endDate (ISO 8601). Optionally filter by calendar name. Supports limit/offset pagination.
- `list_group_members`: List contacts in a specific group.
- `list_groups`: List all contact groups.
- `local_llm_generate`: Generate text using a local Ollama model. Runs entirely on your machine — no data sent to any cloud.
- `local_llm_status`: Check if a local Ollama LLM is available and list installed models.
- `move_file`: Move or rename a file or folder to a new location.
- `proofread_text`: Proofread and correct grammar/spelling using Apple Intelligence (on-device Foundation Models). Requires macOS 26+ with Apple Silicon.
- `read_contact`: Read full details of a contact by ID including all emails, phones, and addresses.
- `read_event`: Read full details of a calendar event by ID. Includes attendees (read-only), location, description, and recurrence info.
- `recent_files`: Find recently modified files in a folder using Spotlight.
- `rewrite_text`: Rewrite text in a specified tone using Apple Intelligence (on-device Foundation Models). Requires macOS 26+ with Apple Silicon.
- `scan_bluetooth`: Scan for nearby BLE (Bluetooth Low Energy) devices. Returns device names, UUIDs, and signal strength (RSSI).
- `scan_document`: Extract text and structure from an image file using Apple Vision framework OCR.
- `search_contacts`: Search contacts by name, email, phone, or organization.
- `search_events`: Search events by keyword in title or description within a date range.
- `search_files`: Search files using Spotlight (mdfind). Searches file names and content.
- `set_file_tags`: Set Finder tags on a file. Replaces all existing tags.
- `summarize_context`: Gather recent context from enabled Apple apps and produce a concise briefing via MCP sampling — read-only; the connected client must support sampling.
- `summarize_text`: Summarize text using Apple Intelligence (on-device Foundation Models). Requires macOS 26+ with Apple Silicon.
- `tag_content`: Classify and tag content using Apple's on-device Foundation Model. Returns confidence scores for each provided tag/category. Requires macOS 26+.
- `today_events`: Get all calendar events for today.
- `trash_file`: Move a file or folder to the Trash using Finder.
- `update_contact`: Update contact properties. Only specified fields are changed.
- `update_event`: Update event properties. Only specified fields are changed. Attendees and recurrence rules cannot be modified via automation.

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.