Skip to content
Back to search

mcp-server-siri-shortcuts

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dvcrn--mcp-server-siri-shortcuts/badge.svg)](/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)

  1. # Siri Shortcuts MCP Server
  2. 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.
  3. ![screenshot](./screenshot.png)
  4. ## Features
  5. - Exposes _all_ shortcuts, meaning the LLM can call anything that is available in the Shortcuts app.
  6. - List all available shortcuts
  7. - Open shortcuts in the Shortcuts app
  8. - Run shortcuts with optional input parameters
  9. - Dynamically generated tools for each available shortcut
  10. ## Tools
  11. ### Base Tools
  12. 1. `list_shortcuts`
  13. - Lists all available Siri shortcuts on the system
  14. - No input required
  15. - Returns: Array of shortcut names
  16. ```json
  17. {
  18. "shortcuts": [{ "name": "My Shortcut 1" }, { "name": "My Shortcut 2" }]
  19. }
  20. ```
  21. 2. `open_shortcut`
  22. - Opens a shortcut in the Shortcuts app
  23. - Input:
  24. - `name` (string): Name of the shortcut to open
  25. 3. `run_shortcut`
  26. - Runs a shortcut with optional input
  27. - Input:
  28. - `name` (string): Name or identifier (UUID) of the shortcut to run
  29. - `input` (string, optional): Text input or filepath to pass to the shortcut
  30. ### Dynamic Tools
  31. The server automatically generates additional tools for each available shortcut in the format:
  32. - Tool name: `run_shortcut_[sanitized_shortcut_name]`
  33. - Description: Runs the specific shortcut
  34. - Input:
  35. - `input` (string, optional): Text input or filepath to pass to the shortcut
  36. ## Configuration
  37. The server supports the following environment variables:
  38. - `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.
  39. - `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.
  40. ## Usage with Claude
  41. Add to your Claude configuration:
  42. ```json
  43. {
  44. "mcpServers": {
  45. "siri-shortcuts": {
  46. "command": "npx",
  47. "args": ["mcp-server-siri-shortcuts"],
  48. "env": {
  49. "GENERATE_SHORTCUT_TOOLS": "true",
  50. "INJECT_SHORTCUT_LIST": "false"
  51. }
  52. }
  53. }
  54. }
  55. ```
  56. ## Implementation Details
  57. - Uses the macOS `shortcuts` CLI command under the hood
  58. - Sanitizes shortcut names for tool naming compatibility
  59. - Supports both direct text input and file-based input
  60. - Returns shortcut output when available
  61. - Implements standard MCP error handling

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.