mcpField
A
Apple Shortcuts MCP Server 🤖

Apple Shortcuts MCP Server 🤖

Local
github.com/recursechatProductivity352Updated 97w ago
Repository

About Apple Shortcuts MCP Server 🤖

Apple Shortcuts MCP Server is an MCP server that lets assistants such as Claude list and run Apple Shortcuts on macOS. It is aimed at macOS users who want to trigger local automations from an AI assistant.

Key features

  1. 01List available shortcuts
  2. 02Run a shortcut by name
  3. 03Pass optional input parameters to shortcuts

Use cases

  1. 01Letting an AI assistant check which shortcuts exist on the machine
  2. 02Triggering shortcut automations through natural language requests

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

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

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmmcp-server-apple-shortcuts

Tools

2

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
namestringYesName of the shortcut to run
inputstringNoOptional input to pass to the shortcut

Details

From the project 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.

README image

README image

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"]
    }
  }
}

Build Apple Shortcuts Server and run locally 🛠️

  1. Clone this repository:
git clone [email protected]:recursechat/mcp-server-apple-shortcuts.git
  1. Install dependencies:
npm install
  1. 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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.