applescript-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
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| system_volumeC | [System control and information] Set system volume |
| system_get_frontmost_appB | [System control and information] Get the name of the frontmost application |
| system_launch_appC | [System control and information] Launch an application |
| system_quit_appC | [System control and information] Quit an application |
| system_toggle_dark_modeB | [System control and information] Toggle system dark mode |
| system_get_battery_statusB | [System control and information] Get battery level and charging status |
| calendar_addC | [Calendar operations] Add a new event to Calendar |
| calendar_listB | [Calendar operations] List all events for today |
| finder_get_selected_filesB | [Finder and file operations] Get currently selected files in Finder |
| finder_search_filesC | [Finder and file operations] Search for files by name |
| finder_quick_look_fileB | [Finder and file operations] Preview a file using Quick Look |
| clipboard_get_clipboardB | [Clipboard management operations] Get current clipboard content |
| clipboard_set_clipboardC | [Clipboard management operations] Set clipboard content |
| clipboard_clear_clipboardC | [Clipboard management operations] Clear clipboard content |
| notifications_toggle_do_not_disturbB | [Notification management] Toggle Do Not Disturb mode using keyboard shortcut |
| notifications_send_notificationC | [Notification management] Send a system notification |
| iterm_paste_clipboardB | [iTerm terminal operations] Paste clipboard content into iTerm |
| iterm_runC | [iTerm terminal operations] Run a command in iTerm |
| mail_create_emailC | [Mail operations] Create a new email in Mail.app |
| mail_list_emailsB | [Mail operations] List emails from a specified mailbox in Mail.app |
| mail_get_emailC | [Mail operations] Get a specific email by search criteria from Mail.app |
| pages_create_documentC | [Pages document operations] Create a new Pages document with plain text content (no formatting) |
| shortcuts_run_shortcutA | [Shortcuts operations] Run a shortcut with optional input. Uses Shortcuts Events to run in background without opening the app. |
| shortcuts_list_shortcutsC | [Shortcuts operations] List all available shortcuts with optional limit |
| messages_list_chatsC | [iMessage operations] List available iMessage and SMS chats |
| messages_get_messagesC | [iMessage operations] Get messages from the Messages app |
| messages_search_messagesC | [iMessage operations] Search for messages containing specific text or from a specific sender |
| messages_compose_messageC | [iMessage operations] Open Messages app with a pre-filled message to a recipient or automatically send a message |
| notes_createC | [Apple Notes operations] Create a new note with optional formatting |
| notes_createRawHtmlC | [Apple Notes operations] Create a new note with direct HTML content |
| notes_listC | [Apple Notes operations] List all notes or notes in a specific folder |
| notes_getB | [Apple Notes operations] Get a specific note by title |
| notes_searchC | [Apple Notes operations] Search for notes containing specific text |
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 33 tools
Tools are well-organized into distinct domains (e.g., Calendar, Clipboard, Finder, Mail, Messages, Notes, Notifications, Pages, Shortcuts, System), with clear purposes within each domain. Minor potential confusion exists between 'notes_create' and 'notes_createRawHtml', which both create notes but with different content formats, but descriptions clarify the distinction.
Tool names follow a highly consistent verb_noun pattern throughout (e.g., calendar_add, clipboard_get_clipboard, finder_search_files). All tools use snake_case consistently, with no deviations in naming conventions, making them predictable and easy to parse.
With 33 tools, the count is borderline high for a single server, potentially overwhelming for agents. However, given the broad scope of automating various macOS applications and system functions, the number is reasonable but could benefit from more modular organization to reduce cognitive load.
The tool set provides comprehensive coverage across multiple macOS domains, with CRUD operations for key apps like Calendar, Mail, Messages, and Notes. Minor gaps exist, such as no update or delete tools for Calendar events or Pages documents, but agents can work around these with existing tools for most workflows.