# Shortcut Forge (Apple Shortcuts MCP)

Shortcut Forge (Apple Shortcuts MCP) is a Claude Code MCP server that builds, checks, and signs Apple Shortcuts. An agent can use it to turn an automation request into an iPhone shortcut file.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: Hyunki6040
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Hyunki6040/shortcut-forge
- Updated: 2026-10-14
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/shortcut-forge-apple-shortcuts-mcp

## What it does

Shortcut Forge turns an automation description into a `.shortcut` file for the Shortcuts app on iPhone. It checks the shortcut before signing; its JSON specification can be read and reviewed as text.

An iPhone accepts the file only after signing, and signing requires a Mac. The MCP server runs through `uvx shortcut-forge`; the README also describes a Mac agent that starts at login and processes files from an iCloud Drive folder.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `SHORTCUT_FORGE_OUT` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env SHORTCUT_FORGE_OUT=<SHORTCUT_FORGE_OUT> --transport stdio shortcut-forge-apple-shortcuts-mcp -- uvx shortcut-forge
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from shortcut-forge <command>

### Codex

**Platform CLI**
```bash
codex mcp add shortcut-forge-apple-shortcuts-mcp --env SHORTCUT_FORGE_OUT=<SHORTCUT_FORGE_OUT> -- uvx shortcut-forge
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from shortcut-forge <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "shortcut-forge-apple-shortcuts-mcp": {
            "command": "uvx",
            "args": [
                "shortcut-forge"
            ],
            "env": {
                "SHORTCUT_FORGE_OUT": "<SHORTCUT_FORGE_OUT>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from shortcut-forge <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "shortcut-forge-apple-shortcuts-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "shortcut-forge"
            ],
            "env": {
                "SHORTCUT_FORGE_OUT": "<SHORTCUT_FORGE_OUT>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from shortcut-forge <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e SHORTCUT_FORGE_OUT=<SHORTCUT_FORGE_OUT> shortcut-forge-apple-shortcuts-mcp uvx shortcut-forge
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from shortcut-forge <command>

## When to use it
- create an Apple Shortcut from an automation description
- check a shortcut before importing it to iPhone
- sign a `.shortcut` file on a Mac

## Example prompts
- Create an Apple Shortcut that adds a reminder based on my description.
- Build a `.shortcut` for this automation and check it before import.
- Sign the finished `.shortcut` file on the Mac.

## Similar
- [Apple Shortcuts Integration](https://affpapa.org/en/nevibecode/skills/apple-shortcuts-integration.md) — skill · 4900 installs
- [Apple Shortcuts](https://affpapa.org/en/nevibecode/mcp/apple-shortcuts.md) — MCP server · ★ 35 repo stars
- [cmux-keyboard-shortcuts](https://affpapa.org/en/nevibecode/skills/cmux-keyboard-shortcuts.md) — skill · 6500 installs
- [Mac Shortcuts — read your Mac from any agent](https://affpapa.org/en/nevibecode/mcp/mac-shortcuts-read-your-mac-from-any-agent.md) — MCP server · ★ 15 repo stars
- [browser-act-skill-forge](https://affpapa.org/en/nevibecode/skills/browser-act-skill-forge.md) — skill · 85200 installs
- [bmad-forge-idea](https://affpapa.org/en/nevibecode/skills/bmad-forge-idea.md) — skill · 17000 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
