📌Overview

Purpose: The Apple Shortcuts MCP server enables AI assistants to control and automate tasks using Apple Shortcuts on macOS through a secure and manageable interface.

Overview: This server implements the Model Context Protocol (MCP) to facilitate interaction between AI applications, like Claude, and Apple Shortcuts. It provides a controlled environment where AI can trigger shortcuts, enhancing automation capabilities on macOS.

Key Features:

Shortcut Listing: Enables AI assistants to list all available shortcuts, providing users visibility over automation options.
Shortcut Execution: Allows AI to run specific shortcuts by name, optionally accepting input parameters to customize the execution, making it versatile for various tasks.

Apple Shortcuts MCP Server 🤖

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

What is MCP? 🤔

The Model Context Protocol (MCP) is a system that enables AI applications to connect to external tools and data sources, providing a secure way for them to interact with local services and APIs while keeping the user in control.

Features 🚀

The Apple Shortcuts MCP server allows AI assistants to:

List available shortcuts
Run shortcuts by name with optional input parameters
Provide a simple interface for automation control

Prerequisites 📋

Before getting started, ensure you have:

Node.js (v18 or higher)
Claude Desktop installed
macOS with the Shortcuts app configured

Configuration ⚙️

To configure Claude Desktop to use the Apple Shortcuts server, use the following JSON:

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

Build and Run Locally 🛠️

To build the Apple Shortcuts MCP server and run it locally, follow these steps:

Clone the repository:

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

Install dependencies:
```
npm install
```
Build the project:
```
npm run build
```

For Claude Desktop configuration to use the local build, use:

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

Usage 🎯

You can instruct Claude to "list shortcuts" or run a specific shortcut by name, such as "get word of the day" or "play a song".

License ⚖️

Apache-2.0