productivitydeveloper-tools

Siri Shortcuts▌

by dvcrn

Access mac keyboard shortcuts for screen capture and automate workflows with Siri Shortcuts. Streamline hotkey screensho

Integrates with macOS Shortcuts to dynamically expose and execute user-defined automation workflows through generated tools.

github stars

★ 182

GitHub npm

Exposes ALL your shortcuts automaticallymacOS onlyDynamic tool generation

best for

/ macOS users with existing Shortcuts workflows
/ Automating personal productivity tasks via AI
/ Integrating custom automations with AI assistants

capabilities

/ List all available macOS shortcuts
/ Run shortcuts with optional input parameters
/ Open shortcuts in the Shortcuts app
/ Generate dynamic tools for each shortcut
/ Pass text or file inputs to shortcuts

what it does

Connects to macOS Shortcuts app to list and run your custom automation workflows from AI assistants. Dynamically generates tools for each shortcut you have installed.

about

Siri Shortcuts is a community-built MCP server published by dvcrn that provides AI assistants with tools and capabilities via the Model Context Protocol. Access mac keyboard shortcuts for screen capture and automate workflows with Siri Shortcuts. Streamline hotkey screensho It is categorized under productivity, developer tools.

how to install

You can install Siri Shortcuts in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

license

GPL-3.0

Siri Shortcuts is released under the GPL-3.0 license.

readme

Siri Shortcuts MCP Server

This 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.

Features

Exposes all shortcuts, meaning the LLM can call anything that is available in the Shortcuts app.
List all available shortcuts
Open shortcuts in the Shortcuts app
Run shortcuts with optional input parameters
Dynamically generated tools for each available shortcut

Tools

Base Tools

list_shortcuts
- Lists all available Siri shortcuts on the system
- No input required
- Returns: Array of shortcut names
```
{
  "shortcuts": [{ "name": "My Shortcut 1" }, { "name": "My Shortcut 2" }]
}
```
open_shortcut
- Opens a shortcut in the Shortcuts app
- Input:
  - name (string): Name of the shortcut to open
run_shortcut
- Runs a shortcut with optional input
- Input:
  - name (string): Name or identifier (UUID) of the shortcut to run
  - input (string, optional): Text input or filepath to pass to the shortcut

Dynamic Tools

The server automatically generates additional tools for each available shortcut in the format:

Tool name: run_shortcut_[sanitized_shortcut_name]
Description: Runs the specific shortcut
Input:
- input (string, optional): Text input or filepath to pass to the shortcut

Configuration

The server supports the following environment variables:

GENERATE_SHORTCUT_TOOLS (default: true): When set to false, disables the generation of dynamic shortcut tools. Only the base tools (list_shortcuts, open_shortcut, run_shortcut) will be available.
INJECT_SHORTCUT_LIST (default: false): When set to true, injects the list of available shortcuts into the run_shortcut tool description to help the LLM understand which shortcuts are available.

Usage with Claude

Add to your Claude configuration:

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

Implementation Details

Uses the macOS shortcuts CLI command under the hood
Sanitizes shortcut names for tool naming compatibility
Supports both direct text input and file-based input
Returns shortcut output when available
Implements standard MCP error handling