shortcuts-mcp-server

shortcuts-mcp-server

8
os_automation

The Shortcuts MCP Server is designed to integrate Apple Shortcuts functionality with AI assistants via Model Context Protocol (MCP). It allows users to manage and execute shortcuts seamlessly across various MCP-supported clients like Cursor and Claude Desktop.

shortcuts-mcp-server

A Model Context Protocol (MCP) server that provides access to Apple Shortcuts functionality. This server allows AI assistants to list, view, and run your shortcuts through the MCP interface.

Compatible with Cursor, Claude Desktop, and other MCP-enabled applications.

Shortcuts MCP Server Preview

Getting started

Prerequisites

  • macOS 14.5 or later
  • Xcode 16.x or later
  • mise

Setup with mise

To install mise:

brew install mise

For more information about mise, visit the official documentation.

Adding to MCP clients

Cursor

For project cofiguration, update .cursor/mcp.json file in your project directory. To use across all projects, create a ~/.cursor/mcp.json file in your home directory.

{
  "mcpServers": {
    "shortcuts-mcp-server": {
      "command": "mise",
      "args": [
        "x",
        "ubi:artemnovichkov/shortcuts-mcp-server@latest",
        "--",
        "shortcuts-mcp-server"
      ]
    }
  }
}

Don't forget to replace the path to the executable.

Read more

Claude Desktop
  1. Open Settings -> Developer -> Edit Config
  2. Open the config file at ~/Library/Application Support/Claude/claude_desktop_config.json and update to:
{
  "mcpServers": {
    "shortcuts-mcp-server": {
      "command": "mise",
      "args": [
        "x",
        "ubi:artemnovichkov/shortcuts-mcp-server@latest",
        "--",
        "shortcuts-mcp-server"
      ]
    }
  }
}

Don't forget to replace the path to the executable.

  1. Restart Claude Desktop.

Read more

VS Code

Install in VS Code

For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing Ctrl + Shift + P and typing Preferences: Open User Settings (JSON).

"mcp": {
    "servers": {
        "shortcuts-mcp-server": {
            "command": "mise",
                "args": [
                    "x",
                    "ubi:artemnovichkov/shortcuts-mcp-server@latest",
                    "--",
                    "shortcuts-mcp-server"
                ]
        }
    }
}

Don't forget to replace the path to the executable.

Read more

Github Copilot for Xcode

Open Settings -> MCP -> Edit Config and update to:

{
    "servers": {
        "shortcuts-mcp-server": {
            "command": "mise",
            "args": [
                "x",
                "ubi:artemnovichkov/shortcuts-mcp-server@latest",
                "--",
                "shortcuts-mcp-server"
            ]
        }
    }
}

Don't forget to replace the path to the executable.

Usage

Just ask LLM to run a shortcut, show a list of added shortcuts or view a shortcut in Shortcuts app.

If your MCP client supports Prompts and Resources you may check it as well: Prompts and resources

Tools

  • run - Run a shortcut.
    • name - The name of the shortcut to run (string, required)
  • list - List your shortcuts.
    • show-identifiers - Whether to show the identifiers of the shortcuts. (boolean, optional)
  • view - View a shortcut in Shortcuts app.
    • name - Name of the shortcut to view (string, required)

Resources

  • list - List your shortcuts.

Prompts

  • run - Run a shortcut.
    • name - Name of the shortcut to run (string, required)
  • list - List your shortcuts.
    • show-identifiers - Whether to show the identifiers of the shortcuts. (boolean, optional)
  • view - View a shortcut in Shortcuts app.
    • name - Name of the shortcut to view (string, required)

References