Apple Shortcuts MCP Server 🤖

1# Apple Shortcuts MCP Server 🤖
2 
3A 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.
4 
5<a href="https://www.npmjs.com/package/mcp-server-apple-shortcuts"><img src="https://img.shields.io/npm/v/mcp-server-apple-shortcuts"/></a>
6 
7<a href="https://glama.ai/mcp/servers/15z6abk6p2"><img width="380" height="200" src="https://glama.ai/mcp/servers/15z6abk6p2/badge" /></a>
8 
9## What is MCP? 🤔
10 
11The 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.
12 
13## What does this server do? 🚀
14 
15The Apple Shortcuts MCP server:
16- Enables AI assistants to list available shortcuts
17- Allows running shortcuts by name with optional input parameters 
18- Provides a simple interface for automation control
19 
20## Prerequisites 📋
21 
22Before you begin, ensure you have:
23 
24- [Node.js](https://nodejs.org/) (v18 or higher)
25- [Claude Desktop](https://claude.ai/download) installed
26- macOS with Shortcuts app configured
27 
28## Configuration to use Apple Shortcuts Server ⚙️
29 
30Here's the Claude Desktop configuration to use the Apple Shortcuts server:
31```json
32{
33  "mcpServers": {
34    "apple-shortcuts": {
35      "command": "npx",
36      "args": ["-y", "mcp-server-apple-shortcuts"]
37    }
38  }
39}
40```
41 
42## Build Apple Shortcuts Server and run locally 🛠️
43 
441. Clone this repository:
45 
46```sh
47git clone git@github.com:recursechat/mcp-server-apple-shortcuts.git
48```
49 
502. Install dependencies:
51```sh
52npm install
53```
54 
553. Build project
56```sh
57npm run build
58```
59 
60Here's the Claude Desktop configuration to use the Apple Shortcuts server with a local build:
61```json
62{
63  "mcpServers": {
64    "apple-shortcuts": {
65      "command": "npx",
66      "args": ["/path/to/mcp-server-apple-shortcuts/build/index.js"],
67    }
68  }
69}
70```
71 
72<!--
73```json
74{
75  "mcpServers": {
76    "apple-shortcuts": {
77      "command": "npx",
78      "args": ["-y", "mcp-server-apple-shortcuts"]
79    }
80  }
81}
82```
83-->
84 
85## Usage 🎯
86 
87You 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".
88 
89## License ⚖️
90 
91Apache-2.0
92