Apple Shortcuts

Discovers all available Apple Shortcuts installed on the macOS system by executing the native `shortcuts list` command and caching results in an internal availableShortcuts array. The server maintains this cache and refreshes it on-demand through the updateShortcutsList function, reducing redundant CLI invocations while ensuring freshness when tools or resources are accessed. This approach leverages macOS's native shortcuts CLI interface rather than parsing filesystem metadata.

Executes named Apple Shortcuts through the MCP protocol by translating AI assistant requests into `shortcuts run "name"` CLI commands with optional string input parameters. The run_shortcut tool handler accepts a required shortcut name and optional input string, executing the shortcut in the macOS environment and returning execution output as text. This bridges natural language intent (e.g., 'run my morning routine') to system-level shortcut execution through standardized MCP tool semantics.

Exposes the cached list of available shortcuts as a machine-readable resource (shortcuts://list) through the MCP resource handler, returning the availableShortcuts array as text/plain content. This allows AI assistants to reference and reason about available shortcuts as a persistent resource within the MCP context, enabling multi-turn conversations where the assistant can refer back to the shortcuts list without re-querying. The resource is backed by the same cache mechanism as the list_shortcuts tool.

Implements a complete MCP server that registers with Claude Desktop through the claude_desktop_config.json configuration file, supporting both NPM package deployment (via `npx mcp-server-apple-shortcuts`) and local build deployment (via compiled build/index.js). The server manages tool and resource handler registration, handles incoming MCP protocol requests, and maintains the internal state (availableShortcuts cache) across the server lifecycle. Configuration is declarative through the mcpServers section of Claude Desktop's config.

Maintains an internal availableShortcuts array that caches the result of the `shortcuts list` CLI command, with an updateShortcutsList function that refreshes the cache on-demand when tools or resources are accessed. This state management pattern reduces CLI invocations (expensive system calls) while ensuring the cache doesn't become stale indefinitely. The cache is refreshed at tool/resource access time rather than on a fixed schedule, balancing freshness with performance.