mcp-server-apple-shortcuts
Author: recursechat
Description: MCP server that lets AI assistants (e.g., Claude) list and execute Apple Shortcuts on macOS through the Model Context Protocol.
Stars: 218
Forks: 20
License: Apache License 2.0
Category: Specialized
Overview
Installation
1. Clone the repository
git clone https://github.com/recursechat/mcp-server-apple-shortcuts.git
cd mcp-server-apple-shortcuts2. Install dependencies (Node.js ≥18 recommended)
npm install # or pnpm install / yarn install3. Create an environment-variable file `.env` (or use system vars)
# MCP server settings
PORT=3000 # port the server will listen on
# Provider keys (example: OpenAI)
OPENAI_API_KEY="sk-..." # needed if the shortcuts call LLM tools4. Start the server
npm run dev # hot-reload (if provided)
# or
npm start # production mode5. (Optional) Build a container image
docker build -t mcp-apple-shortcuts .
docker run -d --env-file .env -p 3000:3000 mcp-apple-shortcutsAfter the server is running, configure the Apple Shortcut on your iOS device to POST requests to `http(s)://<server-host>:3000/mcp` (or whichever route is described in the docs).
01
list available shortcuts
List all Apple Shortcuts that are available to be executed through the MCP server.
02
run shortcuts by name
Execute a specific Apple Shortcut by its name, optionally passing input parameters to the shortcut.
License: Apache License 2.0
Updated 7/30/2025