mcp-server-apple-shortcuts

MCP.Pizza Chef: recursechat

On a Mac with the Shortcuts app set up, this small add-on lets your assistant see the shortcuts you have saved and run any of them by name, optionally handing over a piece of text as input. That covers whatever you have already automated: playing music, sending a message, filing a note, flipping a setting. Be aware that no code has landed since December 2024, so it is effectively unmaintained, although the project has not been archived and names no successor.

Unmaintained ยท no code changes since December 2024; not archived, no successor named
Other

Use This MCP server To

Run a Mac shortcut by name from a chat message See the full list of shortcuts I have saved Play a playlist without switching apps Kick off a saved automation with a bit of text Trigger a home or device routine while I am mid-task

README

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:

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

mcp-server-apple-shortcuts FAQ

Is this project still maintained?
Not actively. The last code change was December 2024. It is still open and not archived, but nothing new has shipped in well over a year.
Does it work on Windows?
No. It relies on the Apple Shortcuts app, so it is macOS only.
Which app do I use it in?
The setup instructions cover Claude Desktop; other apps that support MCP connections should work too.
Do I need to pay for anything or get a key?
No. Nothing beyond the assistant app you already use.
Can I use this to run my morning routine shortcut just by asking?
Yes. Say the shortcut's name and it runs, exactly as if you had tapped it yourself.
How hard is setup?
You paste a few lines into Claude Desktop's settings file and restart the app.
Can it create new shortcuts for me?
No. It only lists and runs shortcuts you have already built in the Shortcuts app.