Recursechat 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 execute tasks on macOS in a secure and controlled manner.

🚀 Quick Start

This server allows AI assistants to interact with Apple Shortcuts on macOS. Before you start, make sure you have installed the necessary software and configured your environment.

✨ Features

• Allows AI assistants to list available shortcuts.
• Supports running shortcuts by name, with optional input parameters.
• Provides a simple interface for automation control.

📦 Installation

Prerequisites

Before you begin, ensure you have installed the following:

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

Configuration for Using the Apple Shortcuts Server

Here is an example configuration for Claude Desktop to connect to the Apple Shortcuts server:

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

Building and Running the 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

To use the locally built server in Claude Desktop, refer to the following configuration:

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

💻 Usage Examples

Basic Usage

You can ask Claude to "List shortcuts" or run a specific shortcut by name, such as "Get Daily Word" or "Play a Song".

📚 Documentation

What is MCP? 🤔

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

📄 License

This project is licensed under the Apache-2.0 license.