Apple Shortcuts MCP Server 🤖
A 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.
<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) 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.
What does this server do? 🚀
The Apple Shortcuts MCP server:
- Enables AI assistants to list available shortcuts
- Allows running shortcuts by name with optional input parameters
- Provides a simple interface for automation control
Prerequisites 📋
Before you begin, ensure you have:
- Node.js (v18 or higher)
- Claude Desktop installed
- macOS with Shortcuts app configured
Configuration to use Apple Shortcuts Server ⚙️
Here's the Claude Desktop configuration to use the Apple Shortcuts server: ``json { "mcpServers": { "apple-shortcuts": { "command": "npx", "args": ["-y", "mcp-server-apple-shortcuts"] } } } ``
Build Apple Shortcuts Server and run locally 🛠️
- Clone this repository:
git clone git@github.com:recursechat/mcp-server-apple-shortcuts.git- Install dependencies:
npm install- Build project
npm run buildHere's the Claude Desktop configuration to use the Apple Shortcuts server with a local build: ``json { "mcpServers": { "apple-shortcuts": { "command": "npx", "args": ["/path/to/mcp-server-apple-shortcuts/build/index.js"], } } } ``
<!-- ``json { "mcpServers": { "apple-shortcuts": { "command": "npx", "args": ["-y", "mcp-server-apple-shortcuts"] } } } `` -->
Usage 🎯
You 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".
License ⚖️
Apache-2.0
