artemnovichkov/shortcuts-mcp-server

Shortcuts + MCP = ♥️

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

Stars: 26

Forks: 4

Open issues: 0

Default branch: main

Primary language: swift

License: MIT

Topics: claude, cursor, mcp-server, swift, vscode

README: README.md