artemnovichkov/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.

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.

Quick install

[[Install MCP Server]](https://cursor.com/en-US/install-mcp?name=shortcuts-mcp-server&config=eyJjb21tYW5kIjoibWlzZSB4IHViaTphcnRlbW5vdmljaGtvdi9zaG9ydGN1dHMtbWNwLXNlcnZlckBsYXRlc3QgLS0gc2hvcnRjdXRzLW1jcC1zZXJ2ZXIifQ%3D%3D)

[[Install in VS Code]](https://insiders.vscode.dev/redirect/mcp/install?name=shortcuts-mcp-server&config=%7B%22command%22%3A%22mise%22%2C%22args%22%3A%5B%22x%22%2C%22ubi%3Aartemnovichkov%2Fshortcuts-mcp-server%40latest%22%2C%22--%22%2C%22shortcuts-mcp-server%22%5D%7D)

Manual installation

Update your MCP configuration with the following server:

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

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

Package Metadata

Repository: artemnovichkov/shortcuts-mcp-server

Default branch: main

README: README.md