Shortcuts

This MCP server gives you a programmatic interface to list, view, and run your Apple Shortcuts through an MCP-enabled client. It lets AI assistants discover shortcuts you’ve added and execute them on demand, enabling seamless automation and integration across tools that support MCP.

How to use

You connect your MCP client to the shortcuts MCP server and issue high-level actions like list, view, or run. Use the list action to see available shortcuts, the view action to open a shortcut in the Shortcuts app, and the run action to execute a shortcut. If your client supports Prompts and Resources, you can request a shortcut action through those interfaces as well.

How to install

Prerequisites you need before installing the server:

• macOS 14.5 or later • Xcode 16.x or later • mise

Install the mise tool using Homebrew:

brew install mise

Manual installation

Add the MCP server configuration for shortcuts-mcp-server into your MCP config under mcpServers. This enables the stdio-based startup using mise with the provided command and arguments.

{
  "mcpServers": {
    "shortcuts_mcp": {
      "command": "mise",
      "args": [
        "x",
        "ubi:artemnovichkov/shortcuts-mcp-server@latest",
        "--",
        "shortcuts-mcp-server"
      ]
    }
  }
}

Notes and tips

• The server runs locally through mise with the exact command and arguments shown. Use this exact setup if you want to start the MCP server via a local workflow.
• If you change shortcuts or want to reload the server, re-run the mise command with the same arguments.

Security and troubleshooting

• Ensure your macOS and Xcode versions meet the prerequisites. Regularly update mise to receive the latest MCP tooling improvements.

Available tools

run

Run a shortcut by name. Creates a request to execute the specified shortcut within the Shortcuts app.

list

List your shortcuts and optionally show their identifiers.

view

View a shortcut in the Shortcuts app by name.