Siri Shortcuts MCP Server

Name: Siri Shortcuts MCP Server
Author: dvcrn

@dvcrn

代码仓库

关于 Siri Shortcuts MCP Server

MCP for calling Siri Shorcuts from LLMs

#mcp #siri-shortcuts #llm #model-context-protocol

基本信息

分类

其他

许可证

GPL-3.0

运行时

node

传输方式

stdio

发布者

dvcrn

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Siri Shortcuts MCP Server?

Siri Shortcuts 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, enabling an LLM to call any shortcut available in the app.

How to use Siri Shortcuts MCP Server?

Configure it in your MCP client (e.g., Claude) by adding a JSON entry with command: "npx" and args: ["mcp-server-siri-shortcuts"]. Optionally set environment variables GENERATE_SHORTCUT_TOOLS (default true) and INJECT_SHORTCUT_LIST (default false) to control dynamic tool generation and shortcut list injection.

Key features of Siri Shortcuts MCP Server

Lists all available Siri shortcuts on the system
Opens a shortcut in the Shortcuts app
Runs shortcuts with optional text input or filepath
Automatically generates a dedicated tool per shortcut
Uses the macOS shortcuts CLI command under the hood
Returns shortcut output when available

Use cases of Siri Shortcuts MCP Server

An LLM lists all available shortcuts to decide which to execute
A shortcut is opened in the Shortcuts app for editing or inspection
A shortcut runs automatically based on LLM reasoning, with optional input
Dynamic tools allow direct invocation of any shortcut without manual mapping

FAQ from Siri Shortcuts MCP Server

What tools does Siri Shortcuts MCP Server provide?

It provides three base tools: list_shortcuts, open_shortcut, and run_shortcut. Additionally, if GENERATE_SHORTCUT_TOOLS is true (default), it creates a dynamic tool for each shortcut named run_shortcut_[sanitized_name].

Can I disable the dynamic shortcut tools?

Yes. Set the environment variable GENERATE_SHORTCUT_TOOLS to false. Then only the three base tools will be available.

How does the server help the LLM know which shortcuts exist?

When INJECT_SHORTCUT_LIST is set to true, the list of available shortcuts is injected into the run_shortcut tool description, helping the LLM understand which shortcuts are available.

What runtime dependencies are required?

The server runs on macOS and relies on the built-in shortcuts CLI command. No additional software is required.

How are inputs passed to shortcuts?

The run_shortcut tool accepts an optional input parameter (string). This can be text directly or a filepath, which is then passed to the shortcut.