Shortcuts 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 | {} |
| logging | {} |
| prompts | {} |
| resources | {} |
| completions | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| run_shortcutA | Execute a macOS Shortcut by name with optional input. Names resolve case-insensitively. If unsure which shortcut to run, call shortcuts_usage with resources: ['shortcuts'] to browse available shortcuts with purpose annotations. Error 1743 means the user must grant automation access in System Settings > Privacy & Security > Automation. |
| shortcuts_usageA | Access shortcut usage history, execution patterns, and user preferences. Before asking the user which shortcut to use, load the shortcuts resource (resources: ['shortcuts']) — entries with 'purposes' describe what shortcuts do, enabling intent matching without prompting. |
| view_shortcutA | Open a macOS Shortcut in the Shortcuts editor for viewing or editing. Use for shortcuts requiring interactive UI (file pickers, dialogs, prompts) since MCP cannot display their interface. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| Recommend a Shortcut | Recommend the best shortcut for a specific task based on available shortcuts and user preferences. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Current shortcuts list | JSON map of available shortcuts keyed by name, each with an ID and optional 'purposes' array from prior usage. Cache refreshes every 24 hours. |
| Live system state | Current system time, timezone, and timestamp for time-based analysis. |
| Execution statistics & insights | AI-generated execution statistics including success rates, timing analysis, and per-shortcut performance data. |
| User preferences & usage patterns | User preferences including favorite shortcuts, workflow patterns, and contextual information. |
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: run_shortcut executes a shortcut, shortcuts_usage provides usage patterns, and view_shortcut opens the editor. There is no overlap or ambiguity.
Names follow snake_case and are mostly verb_noun (run_shortcut, view_shortcut), but shortcuts_usage is a noun_noun form, introducing a slight inconsistency. Overall, the pattern is clear and predictable.
With 3 tools, the server is well-scoped for its purpose of interacting with macOS Shortcuts. Each tool covers a necessary action (run, browse usage, open editor) without unnecessary bloat.
The tool set covers core interactions: execution, usage history, and editing. Shortcuts can be discovered via resources, so there is no dead end. A minor gap might be the lack of a direct list tool, but resources compensate.