mcp-registry/mcp-server-apple-shortcuts

    ==================
      
       /// MCP ///
      /// MCP ///
        
    ==================
        
    [server:online]
    [protocol:ready]

mcp-server-apple-shortcuts

by recursechat

MCP server that lets AI assistants (e.g., Claude) list and execute Apple Shortcuts on macOS through the Model Context Protocol.

218
20
Specialized
GitHubNPM

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.

Installation

1. Clone the repository
git clone https://github.com/recursechat/mcp-server-apple-shortcuts.git cd mcp-server-apple-shortcuts
2. Install dependencies (Node.js ≥18 recommended)
npm install # or pnpm install / yarn install
3. 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 tools
4. Start the server
npm run dev # hot-reload (if provided) # or npm start # production mode
5. (Optional) Build a container image
docker build -t mcp-apple-shortcuts . docker run -d --env-file .env -p 3000:3000 mcp-apple-shortcuts
After 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).

Documentation

License: Apache License 2.0
Updated 7/30/2025

Table of Contents