Skip to content
MCP server

Shortcut Forge (Apple Shortcuts MCP)

Build, lint and sign Apple Shortcuts files from Claude, Codex or any LLM

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, CLI, iOS
Runs
Locally
Version
0.2.1
Listing updated
today

Similar MCP servers

About Shortcut Forge (Apple Shortcuts MCP)

Shortcut Forge (Apple Shortcuts MCP) is an open-source MCP server for ai models and llm tooling. It runs locally on your machine and is started by your AI client.

iOS only imports signed shortcuts, and only a Mac can sign them, which is the gap the project fills. An assistant writes a JSON spec of the automation, and the server turns it into a .shortcut file after checking it against 15 lint rules (SF000 to SF014) built around ways shortcuts really fail on a phone, then signs it automatically on macOS. A launchd agent can also watch an iCloud Drive folder so a spec saved from any device comes back as a signed file in seconds.

The README is explicit about how it differs from other approaches: other Shortcuts servers mostly run shortcuts you already have, whereas this one builds them, produces readable and versionable specs, supports 50 or more step types plus a raw escape hatch, and offers an open library of 20 or more shortcuts with templates such as a supplement tracker and a water log. Remote configuration lets a shared shortcut update without downloading again.

It is a Python package for Claude Code, Claude Desktop, Codex and HTTP clients, and the README says Apple's own builder in iOS 27 is a good choice for quick personal shortcuts.

Install

Run in a terminal

claude mcp add shortcut-forge -- uvx shortcut-forge

Add to claude_desktop_config.json

{
  "mcpServers": {
    "shortcut-forge": {
      "command": "uvx",
      "args": [
        "shortcut-forge"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "shortcut-forge": {
      "command": "uvx",
      "args": [
        "shortcut-forge"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "shortcut-forge": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "shortcut-forge"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "shortcut-forge": {
      "command": "uvx",
      "args": [
        "shortcut-forge"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "shortcut-forge": {
      "command": "uvx",
      "args": [
        "shortcut-forge"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • SHORTCUT_FORGE_OUTOutput folder for generated shortcuts

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

shortcut_build
Converts a JSON spec to a linted .shortcut file, signed on macOS
shortcut_library
Browses and fetches community shortcuts
shortcut_from_template
Builds from a template such as supplement-tracker or water-log
shortcut_lint
Checks an unsigned shortcut against 15 rules
shortcut_inspect
Shows an indented outline of a shortcut

What it does

Spec to shortcut
Builds a `.shortcut` file from a JSON description.
On-device failure lint
Checks 15 rules based on real failures when importing on iPhone.
Mac auto-signing
Signs files in the tool call or through a watched iCloud Drive folder.
Template library
Provides 20 or more community shortcuts and templates to start from.
Inspect and lint exports
Outlines and checks shortcuts exported from the app.
Remote config
Lets shared shortcuts update without a re-download.
Python library
The same builder is available as a Python API and CLI.

Good for

  • Generate a Health logging automation from a plain-language description
  • Debug an exported shortcut that crashes on import
  • Start from a library shortcut such as an expense log and adapt it
  • Version and review shortcuts as readable specs
  • Create shortcuts from a phone chatbot and sign them on a Mac

Pricing

Open source

Shortcut Forge (Apple Shortcuts MCP) FAQ

Can it sign on Windows or Linux?

Signing needs a Mac, which is why the README describes macOS auto-signing.

Which AI clients work?

Claude Code, Claude Desktop, Codex, and others over HTTP or by pasting a prompt file.

Does it only run shortcuts?

No, it builds, lints and signs them, unlike servers that only run existing ones.

How do I install it?

As a Claude plugin, an MCPB bundle, or with uvx or pipx for the Python package.

Is Shortcut Forge (Apple Shortcuts MCP) free?

Yes. Shortcut Forge (Apple Shortcuts MCP) is open source, so you can use and self-host it for free.

How do I add Shortcut Forge (Apple Shortcuts MCP) to Claude Code?

Run this command in your terminal: claude mcp add shortcut-forge -- uvx shortcut-forge

What are the best alternatives to Shortcut Forge (Apple Shortcuts MCP)?

The closest alternatives to Shortcut Forge (Apple Shortcuts MCP) are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers