Siri Shortcuts MCP Server

What does “Siri Shortcuts” MCP Server do?

The Siri Shortcuts MCP Server enables AI assistants to interact directly with the macOS Shortcuts app via the Model Context Protocol (MCP). This server acts as a bridge, allowing large language models (LLMs) to list, open, and run any shortcut available in the user’s Shortcuts app. By exposing these capabilities, developers can enhance their workflows with automation that leverages the power of Siri shortcuts—integrating everything from file operations to complex automation chains. This MCP server dynamically generates tools for every available shortcut, making it easy for clients to trigger automations, pass parameters, and orchestrate macOS actions programmatically through an LLM.

List of Prompts

No explicit prompt templates are documented in the repository. If you need to define reusable prompt templates, you may need to create your own based on your workflow.

List of Resources

No explicit MCP resources are described in the documentation or repository files. Resources typically expose data/content but none are listed for this server.

List of Tools

• list_shortcuts
  • Lists all available Siri shortcuts on the system. No input required. Returns an array of shortcut names.
• open_shortcut
  • Opens a specified shortcut in the Shortcuts app. Input: name (string).
• run_shortcut
  • Runs a specified shortcut, optionally with input parameters. Input: name (string), input (string, optional).
• Dynamic Tools
  • For each available shortcut, a tool is dynamically generated (e.g., run_shortcut_[sanitized_shortcut_name]) to directly run that shortcut with optional input.

Use Cases of this MCP Server

• Automation of Repetitive Tasks
  • Developers can automate frequent workflows, such as launching apps, organizing files, or sending messages, by invoking Siri shortcuts through an LLM.
• Personal Assistant Integration
  • AI agents can interact with user-defined shortcuts to perform tasks like setting reminders, controlling smart home devices, or updating calendars.
• Workflow Testing
  • Allows for automated testing and validation of Siri shortcuts, ensuring they work as expected when triggered programmatically.
• Complex Workflow Orchestration
  • Chain multiple Siri shortcuts together or embed them in broader AI workflows for advanced automation scenarios.
• Dynamic Tooling
  • Instantly expose new shortcuts to LLMs without additional configuration, making it easy to expand available functionality as the user’s shortcuts library grows.

How to set it up

Windsurf

1. Ensure Node.js is installed on your system.
2. Locate your Windsurf configuration file.
3. Add the Siri Shortcuts MCP server to your mcpServers configuration:

   {
     "mcpServers": {
       "siri-shortcuts": {
         "command": "npx",
         "args": ["mcp-server-siri-shortcuts"],
         "env": {
           "GENERATE_SHORTCUT_TOOLS": "true",
           "INJECT_SHORTCUT_LIST": "false"
         }
       }
     }
   }
   

4. Save the configuration and restart Windsurf.
5. Verify the setup by listing available shortcuts through the interface.

Claude

1. Make sure Node.js is installed.
2. Open your Claude configuration file.
3. Add the following MCP server entry:

   {
     "mcpServers": {
       "siri-shortcuts": {
         "command": "npx",
         "args": ["mcp-server-siri-shortcuts"],
         "env": {
           "GENERATE_SHORTCUT_TOOLS": "true",
           "INJECT_SHORTCUT_LIST": "false"
         }
       }
     }
   }
   

4. Save your changes and restart Claude.
5. Confirm proper operation by running a test shortcut.

Cursor

1. Install Node.js if not already present.
2. Open the Cursor configuration file.
3. Insert the MCP server configuration:

   {
     "mcpServers": {
       "siri-shortcuts": {
         "command": "npx",
         "args": ["mcp-server-siri-shortcuts"],
         "env": {
           "GENERATE_SHORTCUT_TOOLS": "true",
           "INJECT_SHORTCUT_LIST": "false"
         }
       }
     }
   }
   

4. Save and restart Cursor.
5. Ensure the server is accessible from Cursor’s AI features.

Cline

1. Ensure Node.js is installed.
2. Open the Cline configuration file.
3. Add the Siri Shortcuts MCP Server configuration:

   {
     "mcpServers": {
       "siri-shortcuts": {
         "command": "npx",
         "args": ["mcp-server-siri-shortcuts"],
         "env": {
           "GENERATE_SHORTCUT_TOOLS": "true",
           "INJECT_SHORTCUT_LIST": "false"
         }
       }
     }
   }
   

4. Save the file and restart Cline.
5. Test the integration by listing available shortcuts.

Securing API Keys:
If you need to secure sensitive environment variables (e.g., API keys), use the env field in your configuration:

{
  "mcpServers": {
    "siri-shortcuts": {
      "command": "npx",
      "args": ["mcp-server-siri-shortcuts"],
      "env": {
        "YOUR_API_KEY": "${YOUR_API_KEY_ENV_VAR}",
        "GENERATE_SHORTCUT_TOOLS": "true"
      }
    }
  }
}

Make sure to set the actual environment variable outside of your configuration file (e.g., in your shell or CI/CD environment).

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "siri-shortcuts": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change “siri-shortcuts” to whatever the actual name of your MCP server is and replace the URL with your own MCP server URL.

Overview

Roots Support: Not mentioned in the repository.

Based on the above tables, the Siri Shortcuts MCP Server provides solid tooling and setup instructions but lacks explicit support for MCP resources, prompt templates, roots, or sampling. It is best suited for workflows focused on shortcut automation, and its dynamic tool generation is a notable strength.

Our opinion

For shortcut automation on macOS, this MCP server is quite specialized and strong in its area. However, for broader MCP support (prompts, resources, roots, sampling), it is limited. Overall, it is well-suited for users who need Siri shortcut integration but not for those needing advanced MCP features across the board.

MCP Score