Back to search
mcp-server-siri-shortcuts
MCP serverGitHub
MCP for calling Siri Shorcuts from LLMs
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/dvcrn--mcp-server-siri-shortcuts)HTML
<a href="/listings/dvcrn--mcp-server-siri-shortcuts"><img src="/api/listings/dvcrn--mcp-server-siri-shortcuts/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 84 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Siri Shortcuts MCP Server
- This MCP server provides access to Siri shortcuts functionality via the Model Context Protocol (MCP). It allows listing, opening, and running shortcuts from the macOS Shortcuts app.
- 
- ## Features
- - Exposes _all_ shortcuts, meaning the LLM can call anything that is available in the Shortcuts app.
- - List all available shortcuts
- - Open shortcuts in the Shortcuts app
- - Run shortcuts with optional input parameters
- - Dynamically generated tools for each available shortcut
- ## Tools
- ### Base Tools
- 1. `list_shortcuts`
- - Lists all available Siri shortcuts on the system
- - No input required
- - Returns: Array of shortcut names
- ```json
- {
- "shortcuts": [{ "name": "My Shortcut 1" }, { "name": "My Shortcut 2" }]
- }
- ```
- 2. `open_shortcut`
- - Opens a shortcut in the Shortcuts app
- - Input:
- - `name` (string): Name of the shortcut to open
- 3. `run_shortcut`
- - Runs a shortcut with optional input
- - Input:
- - `name` (string): Name or identifier (UUID) of the shortcut to run
- - `input` (string, optional): Text input or filepath to pass to the shortcut
- ### Dynamic Tools
- The server automatically generates additional tools for each available shortcut in the format:
- - Tool name: `run_shortcut_[sanitized_shortcut_name]`
- - Description: Runs the specific shortcut
- - Input:
- - `input` (string, optional): Text input or filepath to pass to the shortcut
- ## Configuration
- The server supports the following environment variables:
- - `GENERATE_SHORTCUT_TOOLS` (default: `true`): When set to `false`, disables the generation of dynamic shortcut tools. Only the base tools (`list_shortcuts`, `open_shortcut`, `run_shortcut`) will be available.
- - `INJECT_SHORTCUT_LIST` (default: `false`): When set to `true`, injects the list of available shortcuts into the `run_shortcut` tool description to help the LLM understand which shortcuts are available.
- ## Usage with Claude
- Add to your Claude configuration:
- ```json
- {
- "mcpServers": {
- "siri-shortcuts": {
- "command": "npx",
- "args": ["mcp-server-siri-shortcuts"],
- "env": {
- "GENERATE_SHORTCUT_TOOLS": "true",
- "INJECT_SHORTCUT_LIST": "false"
- }
- }
- }
- }
- ```
- ## Implementation Details
- - Uses the macOS `shortcuts` CLI command under the hood
- - Sanitizes shortcut names for tool naming compatibility
- - Supports both direct text input and file-based input
- - Returns shortcut output when available
- - Implements standard MCP error handling
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.