Siri Shortcuts Control

v1.0.0Developer Toolsstable

Enables interaction with macOS Siri Shortcuts via the Model Context Protocol, allowing users to list, open, and run shortcuts dynamically with optional inputs.

llmmcpmodel-context-protocolsiri-shortcuts
Share:
189
Stars
0
Downloads
0
Weekly
0/5

What is Siri Shortcuts Control?

Siri Shortcuts Control is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables interaction with macos siri shortcuts via the model context protocol, allowing users to list, open, and run shortcuts dynamically with optional inputs.

Enables interaction with macOS Siri Shortcuts via the Model Context Protocol, allowing users to list, open, and run shortcuts dynamically with optional inputs.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Enables interaction with macOS Siri Shortcuts via the Model

Use Cases

List and run macOS Siri Shortcuts
Automate desktop workflows
Optional shortcut inputs
dvcrn

Maintainer

LicenseGPL 3.0
Languagetypescript
Versionv1.0.0
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx siri-shortcuts-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Siri Shortcuts Control

The Siri Shortcuts MCP server bridges macOS Siri Shortcuts with any MCP-compatible AI client, letting an AI list, open, and run any shortcut on your Mac — including passing optional text or file inputs. Because it auto-generates a dedicated tool for every shortcut on the system, AI agents can trigger complex automations (home control, file processing, app actions) without writing any glue code. It is ideal for macOS power users who want to expose their existing Shortcuts library to Claude or other LLM tools.

Prerequisites

  • macOS with the Shortcuts app (macOS 12 Monterey or later recommended)
  • Node.js 18 or newer and npx available
  • Claude Desktop or another MCP-capable client running on macOS
  • One or more Siri Shortcuts already created in the Shortcuts app
1

Confirm you have Siri Shortcuts set up on macOS

Open the Shortcuts app and verify you have at least one shortcut. The MCP server lists and runs existing shortcuts — it does not create them.

2

Test the server manually with npx

Run the package once with npx to confirm it starts without errors before adding it to your MCP client configuration.

npx mcp-server-siri-shortcuts
3

Add the server to your MCP client configuration

Edit your claude_desktop_config.json to add the Siri Shortcuts server. Set GENERATE_SHORTCUT_TOOLS to true so each shortcut gets its own auto-generated tool.

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

Restart Claude Desktop

Quit and reopen Claude Desktop (or your MCP client) to load the new server. The client will connect and auto-generate tools for each shortcut found on the system.

5

Ask the AI to list your shortcuts

Verify the connection by asking the AI to list all available shortcuts. It will call list_shortcuts and return all shortcut names discovered on your Mac.

Siri Shortcuts Control Examples

Client configuration

Full claude_desktop_config.json entry for the Siri Shortcuts MCP server with dynamic tool generation enabled.

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

Prompts to try

These prompts let the AI interact with your macOS Siri Shortcuts library through the three base tools and auto-generated per-shortcut tools.

- "List all my Siri Shortcuts"
- "Run my 'Morning Routine' shortcut"
- "Open the 'Resize Images' shortcut in the Shortcuts app so I can edit it"
- "Run my 'Send Daily Report' shortcut with input 'Sales summary for June'"
- "Which of my shortcuts can accept text input?"

Troubleshooting Siri Shortcuts Control

No shortcuts appear when listing or tool generation produces zero tools

The server calls the macOS 'shortcuts' CLI command. Verify it works by running 'shortcuts list' in Terminal. If it prompts for permission, grant Automation access to Terminal (or your MCP client app) in System Settings > Privacy & Security > Automation.

run_shortcut returns an error for a specific shortcut

Some shortcuts require user interaction or specific app context and cannot run headlessly. Test the shortcut manually in the Shortcuts app first. Shortcuts that open a GUI dialog will likely fail when triggered from the MCP server.

npx mcp-server-siri-shortcuts fails with 'command not found' for npx

Install Node.js from https://nodejs.org (LTS version). After installation, open a new Terminal and confirm 'node --version' and 'npx --version' both return version numbers before restarting Claude Desktop.

Frequently Asked Questions about Siri Shortcuts Control

What is Siri Shortcuts Control?

Siri Shortcuts Control is a Model Context Protocol (MCP) server that enables interaction with macos siri shortcuts via the model context protocol, allowing users to list, open, and run shortcuts dynamically with optional inputs. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Siri Shortcuts Control?

Follow the installation instructions on the Siri Shortcuts Control GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Siri Shortcuts Control?

Siri Shortcuts Control works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Siri Shortcuts Control free to use?

Yes, Siri Shortcuts Control is open source and available under the GPL 3.0 license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

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

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Siri Shortcuts Control?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides