Shortcuts

Name: Shortcuts
Author: artemnovichkov

@artemnovichkov

Repository

About Shortcuts

Shortcuts + MCP = ♥️

#swift #macos #mcp-server #shortcuts

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "shortcuts-mcp-server": {
      "type": "stdio",
      "command": "/absolute/path/to/shortcuts-mcp-server/.build/arm64-apple-macosx/debug/shortcuts-mcp-server"
    }
  }
}

Tools

Run a shortcut.

List your shortcuts.

View a shortcut in Shortcuts app.

Overview

What is Shortcuts?

Shortcuts is a Model Context Protocol (MCP) server that provides AI assistants with access to Apple Shortcuts functionality. It lets users list, view, and run their shortcuts through the MCP interface, and is compatible with Cursor, Claude Desktop, and other MCP‑enabled applications.

How to use Shortcuts?

Install the server using mise (prerequisite) or by adding the manual configuration shown in the README. Once configured, simply ask an LLM to run a shortcut, show a list of added shortcuts, or view a shortcut in the Shortcuts app.

Key features of Shortcuts

Run a shortcut by name.
List all shortcuts, with optional identifiers.
View a shortcut in the Shortcuts app.
Supports Prompts and Resources in compatible clients.
Native integration with Apple Shortcuts on macOS.

Use cases of Shortcuts

Ask an AI assistant to execute a daily workflow shortcut (e.g., “run my morning routine”).
Get a list of all installed shortcuts to discover what is available.
Open a specific shortcut in the Shortcuts app for editing or inspection.
Combine with other MCP servers in a multi‑tool AI workflow.

FAQ from Shortcuts

What are the system requirements for Shortcuts?

The server requires macOS 14.5 or later, Xcode 16.x or later, and mise (installable via brew install mise).

How do I install Shortcuts?

You can install it via the one‑click links for Cursor or VS Code, or manually by adding the JSON configuration shown in the README. The server runs through mise.

Which applications are compatible with Shortcuts?

Shortcuts is compatible with Cursor, Claude Desktop, and other MCP‑enabled applications.

What tools does Shortcuts provide?

The server provides three tools: run (runs a shortcut by name), list (lists shortcuts, optionally showing identifiers), and view (opens a shortcut in the Shortcuts app).