MCP Server Apple Shortcuts

🚀 Apple Shortcuts MCP Server 🤖

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

🚀 Quick Start

What is MCP? 🤔

Model Context Protocol (MCP) is a system that allows AI applications (such as Claude Desktop) to connect to external tools and services. It enables AI assistants to interact with local services and APIs in a clear and secure way while keeping users in control.

What are the functions of this server? 🚀

The Apple Shortcuts MCP server:

• Allows AI assistants to list available shortcuts.
• Supports running shortcuts by name and optionally passing input parameters.
• Provides a simple interface for automated control.

📦 Installation

Prerequisites 📋

Before you start, make sure you have installed the following:

• Node.js (version 18 or higher).
• Claude Desktop installed.
• The Shortcuts app configured on macOS.

Configuration for using the Apple Shortcuts server ⚙️

Here is an example of the Claude Desktop configuration for using the Apple Shortcuts server:

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

Building and running the Apple Shortcuts server locally 🛠️

1. Clone this repository:

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

2. Install dependencies:

npm install

3. Build the project:

npm run build

Here is an example of the Claude Desktop configuration for using the locally built Apple Shortcuts server:

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

💻 Usage Examples

Basic Usage

You can ask Claude to perform operations like "List shortcuts" or "Run 'Get a word'", for example: "Get a word" or "Play a song".

📄 License

Apache-2.0