shortcuts-mcp

MCP server that lists, inspects, searches, and runs macOS Shortcuts.

Setup

uv run shortcuts-mcp

MCP Tools

• list_shortcuts(folder?, include_actions?)
• get_shortcut(name, include_actions?)
• search_shortcuts(query, search_in?)
• get_folders()
• get_available_actions(source?, category?, search?, include_parameters?, include_examples?, force_refresh?)
• run_shortcut(name, input?, wait_for_result?, timeout?)

Environment Variables

SHORTCUTS_DB_PATH="~/Library/Shortcuts/Shortcuts.sqlite"
SHORTCUTS_DEFAULT_TIMEOUT=30
SHORTCUTS_LOG_LEVEL="INFO"

Claude Code Integration

{
  "mcpServers": {
    "shortcuts": {
      "command": "uv",
      "args": ["--directory", "/path/to/shortcuts-mcp", "run", "shortcuts-mcp"]
    }
  }
}