Apple Shortcuts

Provides access to Apple Shortcuts via MCP to list and run shortcuts on macOS.

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can use the Apple Shortcuts MCP Server to let AI assistants trigger and control Shortcuts automations on your macOS device. It provides a safe, structured way for AI models to list available shortcuts and run them by name with optional input parameters, enabling powerful automations while keeping you in control.

How to use

With an MCP client, you can list what shortcuts are available and then execute a shortcut by its name. You can also pass optional input to a shortcut when you run it. Start by listing shortcuts to see what’s available, then choose a specific shortcut to run and provide any required input data. This workflow lets your AI assistant trigger macOS automations in a controlled, user-visible way.

How to install

Prerequisites you need before you begin are Node.js version 18 or higher, Claude Desktop installed, and macOS with the Shortcuts app configured.

Step 1: Set up the MCP server by installing dependencies and building the project.

# Clone the project
git clone git@github.com:recursechat/mcp-server-apple-shortcuts.git

# Move into the project directory
cd mcp-server-apple-shortcuts

# Install dependencies
npm install

# Build the project
npm run build

Configure your MCP client for the Apple Shortcuts server

You can configure your MCP client to connect to the Apple Shortcuts MCP server using an MCP configuration snippet.

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

Available tools

list_shortcuts

Lists all available Shortcuts that the MCP server can expose to the AI assistant.

run_shortcut

Runs a specified Shortcut by name with optional input parameters to automate tasks on macOS.