drio
Open app

Apple Shortcuts MCP Server 🤖

Source

Catalog onlyCatalog onlySTDIO

Overview

The Apple Shortcuts MCP Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude to control and automate tasks using Apple Shortcuts on macOS.

To use the Apple Shortcuts MCP Server, you need to install prerequisites (Node.js and Claude Desktop), clone the repository, install the dependencies, and configure Claude Desktop to communicate with the server. Once set up, you can give commands to Claude to list or run shortcuts.

  • Enables listing of available Apple Shortcuts. - Allows execution of shortcuts by name with optional parameters. - Provides a straightforward interface for automation within macOS.
  1. Automating routine tasks like sending messages or playing music.
  2. Integration with AI assistants to enhance productivity.
  3. Triggering complex workflows that involve multiple shortcuts.

Add to your AI client

Use these steps to connect Apple Shortcuts MCP Server 🤖 in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

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

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

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

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

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

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "mcp-server-apple-shortcuts-recursechat": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-apple-shortcuts-recursechat"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

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

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

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

FAQ

What do I need to run this server?

You need Node.js (v18 or higher), Claude Desktop, and macOS with the Shortcuts app set up.

Can I run any Apple Shortcut?

Yes, you can trigger any available shortcut by mentioning its name.

How do I configure Claude Desktop with the MCP server?

Follow the provided configuration instructions to set the MCP server in Claude Desktop.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":151,"uuid":"089669f5-ecdc-4e35-a55f-4268d3f3ae12","name":"mcp-server-apple-shortcuts","title":"Apple Shortcuts MCP Server 🤖","description":"","avatar_url":"https://avatars.githubusercontent.com/u/158546902?v=4","created_at":"2024-12-13T09:01:32.870Z","updated_at":"2024-12-13T09:42:47.634Z","status":"created","author_name":"recursechat","author_avatar_url":"https://avatars.githubusercontent.com/u/158546902?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/recursechat/mcp-server-apple-shortcuts","target":"_self","content":"$29","summary":"$2a","img_url":"https://camo.githubusercontent.com/abd6994a4b02bbb1adfcf41bd7d273fbe04ce15836bbf70f2e1761bc77edc7a7/68747470733a2f2f696d672e736869656c64732e696f2f6e706d2f762f6d63702d7365727665722d6170706c652d73686f727463757473","type":null,"metadata":"{\"star\":\"170\",\"license\":\"Apache-2.0 license\",\"language\":\"JavaScript\",\"is_official\":false,\"latest_commit_time\":\"2024-12-21 19:27:15\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools