Home / MCP / Siri Shortcuts MCP Server
Provides access to Siri Shortcuts via MCP, enabling listing, opening, and running shortcuts from macOS Shortcuts app.
Configuration
View docs{
"mcpServers": {
"siri_shortcuts": {
"command": "npx",
"args": [
"mcp-server-siri-shortcuts"
],
"env": {
"GENERATE_SHORTCUT_TOOLS": "true",
"INJECT_SHORTCUT_LIST": "false"
}
}
}
}You can run Siri Shortcuts as MCP tools, giving you programmatic access to list, open, and execute shortcuts from the macOS Shortcuts app. This server exposes core shortcuts management as MCP endpoints and can dynamically generate tools for each available shortcut, letting you call them directly from your MCP client.
Use a compatible MCP client to interact with the Siri Shortcuts MCP Server. You can list all shortcuts, open a shortcut in the Shortcuts app, or run a shortcut with optional input. The server also creates dedicated dynamic tools for each shortcut when generation is enabled, so you can call a specific shortcut directly.
Base tools you can invoke include: a) list_shortcuts to retrieve all available shortcuts, b) open_shortcut to open a shortcut in the Shortcuts app, and c) run_shortcut to execute a shortcut with optional input. If dynamic tool generation is enabled, you will also see tools named like run_shortcut_<sanitized_shortcut_name> for each shortcut.
Prerequisites: you need Node.js and npm/npx available on your system.
Install and run the MCP server using the package runner shown in the example configuration.
{
"mcpServers": {
"siri_shortcuts": {
"command": "npx",
"args": ["mcp-server-siri-shortcuts"],
"env": {
"GENERATE_SHORTCUT_TOOLS": "true",
"INJECT_SHORTCUT_LIST": "false"
}
}
}
}Configuration and usage details are provided as part of the server setup. The server relies on the macOS shortcuts CLI to list, open, and run shortcuts, and it sanitizes shortcut names to ensure they work reliably as tool identifiers. It accepts both direct text input and file-based input and returns shortcut output when available. Standard MCP error handling is implemented to provide clear feedback on failures.
Notes about environment variables and tool generation:
- GENERATE_SHORTCUT_TOOLS controls whether dynamic tools for each shortcut are created. When true, you get run_shortcut_<sanitized_shortcut_name> tools in addition to the base tools.
- INJECT_SHORTCUT_LIST, when true, injects the list of available shortcuts into the run_shortcut tool description to help you understand what can be run.
Only run shortcuts you trust. The server exposes all shortcuts it can access, so ensure your environment isolates this capability to authorized clients. When possible, restrict who can call the MCP server and monitor tool usage to prevent unintended automation.
Lists all available Siri shortcuts on the system. No input required. Returns an array of shortcut names.
Opens a shortcut in the Shortcuts app. Input: name (string) of the shortcut to open.
Runs a shortcut with optional input. Input: name (string) of the shortcut to run and optional input (string or file path).