Siri Shortcuts MCP server

This MCP server integrates Siri shortcuts functionality via the Model Context Protocol, allowing AI assistants to list, open, and run any shortcuts from your macOS Shortcuts app. It dynamically generates tools that correspond to your available shortcuts.

Installation

To install the Siri Shortcuts MCP server:

npm install -g mcp-server-siri-shortcuts

Configuration

Setting Up with Claude

To use this server with Claude, add the following to your Claude configuration:

{
  "mcpServers": {
    "siri-shortcuts": {
      "command": "npx",
      "args": ["mcp-server-siri-shortcuts"]
    }
  }
}

Available Tools

Core Tools

The server provides three basic tools:

1. list_shortcuts

   • Lists all available Siri shortcuts on your system
   • No input required
   • Returns an array of shortcut names:

     {
       "shortcuts": [{ "name": "My Shortcut 1" }, { "name": "My Shortcut 2" }]
     }
     

2. open_shortcut

   • Opens a shortcut in the Shortcuts app for viewing or editing
   • Required input:
     • name (string): Name of the shortcut to open

3. run_shortcut

   • Executes a shortcut with optional input
   • Required input:
     • name (string): Name of the shortcut to run
   • Optional input:
     • input (string): Text input or filepath to pass to the shortcut

Dynamic Shortcut Tools

The server automatically generates additional tools for each of your shortcuts:

• Tool name format: run_shortcut_[sanitized_shortcut_name]
• Each tool runs its specific shortcut
• Optional input parameter for passing text or file paths

Usage Examples

Listing Available Shortcuts

To get a list of all shortcuts:

{
  "tool_name": "list_shortcuts",
  "parameters": {}
}

Opening a Shortcut

To open a shortcut in the Shortcuts app:

{
  "tool_name": "open_shortcut",
  "parameters": {
    "name": "My Weather Report"
  }
}

Running a Shortcut

To run a shortcut using the generic tool:

{
  "tool_name": "run_shortcut",
  "parameters": {
    "name": "Summarize Text",
    "input": "This is the text I want to summarize."
  }
}

Using a Dynamic Shortcut Tool

To run a specific shortcut using its dedicated tool:

{
  "tool_name": "run_shortcut_summarize_text",
  "parameters": {
    "input": "This is the text I want to summarize."
  }
}

Notes on Functionality

• The server uses the macOS shortcuts CLI command
• Shortcut names are sanitized for tool naming compatibility
• You can provide direct text input or file paths to shortcuts
• The server properly handles and returns the shortcut's output when available

How to add this MCP server to Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "cursor-rules-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cursor-rules-mcp"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.