apple-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
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
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| apple_notes_listB | List notes with title, snippet, folder name, and dates. Returns a paginated JSON array. |
| apple_notes_searchA | Search notes by keyword in title and snippet text. |
| apple_notes_getA | Get the full plaintext body of a note by its exact title. Uses JXA to read from Apple Notes app. |
| apple_notes_foldersA | List all Apple Notes folders with note counts. |
| apple_notes_recentB | Get the N most recently modified notes. |
| apple_notes_by_folderA | Get all notes in a specific folder by folder name. |
| apple_notes_createB | Create a new note in Apple Notes. Uses JXA. |
| apple_notes_statsA | Get aggregate statistics: total notes, notes per folder, date range. |
| apple_reminders_listsA | List all reminder lists with reminder counts. Returns a JSON array of {name, count}. |
| apple_reminders_listA | Get all reminders in a specific list. Returns name, completed, due date, priority, and notes for each. |
| apple_reminders_dueA | Get reminders due today, this week, or overdue. Only returns incomplete reminders. |
| apple_reminders_searchA | Search reminders by keyword across all lists (case-insensitive name match). |
| apple_reminders_createB | Create a new reminder in Apple Reminders. |
| apple_reminders_completeA | Mark a reminder as complete by name. Optionally narrow search to a specific list. |
| apple_safari_historyB | Get recent Safari browsing history. Returns URLs, titles, visit times. |
| apple_safari_search_historyB | Search Safari browsing history by URL or page title keyword. |
| apple_safari_bookmarksA | List Safari bookmarks. Optionally filter by folder name. |
| apple_safari_reading_listA | Get all items from Safari Reading List. |
| apple_calendar_todayA | Get today's events across all calendars. |
| apple_calendar_rangeC | Get events in a date range. |
| apple_calendar_calendarsA | List all calendars. |
| apple_calendar_searchB | Search events by title. |
| apple_calendar_upcomingB | Get next N upcoming events from now. |
| apple_contacts_searchB | Search contacts by name, email, or company. |
| apple_contacts_getA | Get full contact details by ID (Z_PK), including emails and phone numbers. |
| apple_contacts_recentB | Get recently modified contacts. |
| apple_contacts_companyA | List contacts at a specific company. |
| apple_contacts_statsA | Contact count and top companies by contact count. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 28 tools
Each tool targets a distinct resource and action within its domain (calendar, contacts, notes, reminders, safari). For instance, calendar tools separate listing calendars, querying date ranges, searching by title, today's events, and upcoming events without overlap. Similarly, contacts have distinct tools for search, get by ID, recent, company filter, and stats.
All tools follow the consistent pattern `apple_<domain>_<action>` in snake_case, e.g., `apple_calendar_calendars`, `apple_contacts_search`, `apple_notes_create`. No mixing of camelCase or other conventions, making it predictable for an agent.
With 28 tools covering five major Apple apps, the count is on the higher end but not excessive for the broad scope. Each tool has a clear purpose, though some domains could be split into separate servers for better focus.
The tool set is heavily read-oriented with only two create tools (notes and reminders) and no update or delete capabilities. Missing CRUD operations for calendars, contacts, and safari, which limits agent ability to perform full lifecycle tasks.