Apple Shortcuts MCP Server 🤖

This repository hosts a Model Context Protocol (MCP) server designed to allow AI assistants like Claude to control Apple Shortcuts on macOS. This setup enables AI models to trigger shortcuts and automate tasks in a secure and controlled environment.

<a href="https://www.npmjs.com/package/mcp-server-apple-shortcuts"><img src="https://img.shields.io/npm/v/mcp-server-apple-shortcuts"/></a>

<a href="https://glama.ai/mcp/servers/15z6abk6p2"><img width="380" height="200" src="https://glama.ai/mcp/servers/15z6abk6p2/badge" /></a>

What is MCP? 🤔

The Model Context Protocol (MCP) facilitates connections between AI applications, such as Claude Desktop, and external tools or data sources. It provides a secure and transparent method for AI assistants to interact with local services and APIs, ensuring user oversight.

What does this server do? 🚀

The Apple Shortcuts MCP server offers the following functionalities:

• Lists available shortcuts to AI assistants.
• Executes shortcuts by name, accepting optional input parameters.
• Provides a straightforward interface for automation control.

Prerequisites 📋

Ensure the following prerequisites are met:

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

Configuration to use Apple Shortcuts Server ⌘š™ï¸

To configure Claude Desktop to use the Apple Shortcuts server, add the following to your configuration:

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

Build Apple Shortcuts Server and run locally 🛠️

1. Clone the repository: git clone [email protected]:recursechat/mcp-server-apple-shortcuts.git
2. Install dependencies: npm install
3. Build the project: npm run build

To use a local build, configure Claude Desktop as follows:

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

Usage 🎯

Interact with Claude by requesting "list shortcuts" or executing specific shortcuts by name, such as "get word of the day" or "play a song".

License ⌘š–️

Apache-2.0