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:

• node.js (v18 or higher)
• claude desktop installed
• macos with shortcuts app configured

configuration to use apple shortcuts server ⚙️

here's the claude desktop configuration to use the apple shortcuts server:

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

build apple shortcuts server and run locally 🛠️

1. clone this repository:

git clone git@github.com:recursechat/mcp-server-apple-shortcuts.git

2. install dependencies:

npm install

3. build project

npm run build

here's the claude desktop configuration to use the apple shortcuts server with a local build:

{
  "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