# Shortcut Forge (Apple Shortcuts MCP)

> Shortcut Forge (Apple Shortcuts MCP) is an open-source MCP server for ai models and llm tooling. Build, lint and sign Apple Shortcuts files from Claude, Codex or any LLM. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, CLI, iOS, self-hosted
- **Repository:** https://github.com/hyunki6040/shortcut-forge
- **MCP Registry name:** io.github.Hyunki6040/shortcut-forge
- **Categories:** [AI models and LLM tooling](https://ai-powered.com/categories/ai-and-llm), [productivity](https://ai-powered.com/categories/productivity), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add shortcut-forge -- uvx shortcut-forge
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/shortcut-forge-apple-shortcuts-mcp
