MCP Server Apple Shortcuts README

The full upstream README, mirrored for reference. Install config, tool schemas, adoption signals and our own overview live on the MCP Server Apple Shortcuts listing page.

Apple Shortcuts MCP Server πŸ€–

A Model Context Protocol (MCP) server that lets AI assistants like Claude control Apple Shortcuts automations. This enables AI models to trigger shortcuts and automate tasks on macOS in a safe and controlled way.

What is MCP? πŸ€”

The Model Context Protocol (MCP) is a system that lets AI apps, like Claude Desktop, connect to external tools and data sources. It gives a clear and safe way for AI assistants to work with local services and APIs while keeping the user in control.

What does this server do? πŸš€

The Apple Shortcuts MCP server:

  • Enables AI assistants to list available shortcuts
  • Allows running shortcuts by name with optional input parameters
  • Provides a simple interface for automation control

Prerequisites πŸ“‹

Before you begin, ensure you have:

Configuration to use Apple Shortcuts Server βš™οΈ

Here's the Claude Desktop configuration to use the Apple Shortcuts server:

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

Build Apple Shortcuts Server and run locally πŸ› οΈ

  1. Clone this repository:
sh
git clone git@github.com:recursechat/mcp-server-apple-shortcuts.git
  1. Install dependencies:
Terminal
npm install
  1. Build project
Terminal
npm run build

Here's the Claude Desktop configuration to use the Apple Shortcuts server with a local build:

config.json
{
  "mcpServers": {
    "apple-shortcuts": {
      "command": "npx",
      "args": ["/path/to/mcp-server-apple-shortcuts/build/index.js"],
    }
  }
}

Usage 🎯

You can ask Claude "list shortcuts" or run a specific shortcut with the shortcut name, for example "get word of the day" or "play a song".

License βš–οΈ

Apache-2.0