Shortcut Forge — Claude Code MCP server for Apple Shortcuts
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.
MIT ★ 5 updated 2026-10-14
claude mcp add --env SHORTCUT_FORGE_OUT=<SHORTCUT_FORGE_OUT> --transport stdio shortcut-forge-apple-shortcuts-mcp -- uvx shortcut-forgeWhat Shortcut Forge (Apple Shortcuts MCP) 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.
What it helps with
- create an Apple Shortcut from an automation description
- check a shortcut before importing it to iPhone
- sign a
.shortcutfile on a Mac
Example prompts for the agent
- Create an Apple Shortcut that adds a reminder based on my description.
- Build a
.shortcutfor this automation and check it before import. - Sign the finished
.shortcutfile on the Mac.
How to install Shortcut Forge (Apple Shortcuts MCP)
Platform CLI
claude mcp add --env SHORTCUT_FORGE_OUT=<SHORTCUT_FORGE_OUT> --transport stdio shortcut-forge-apple-shortcuts-mcp -- uvx shortcut-forgeReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from shortcut-forge <command>
Platform CLI
codex mcp add shortcut-forge-apple-shortcuts-mcp --env SHORTCUT_FORGE_OUT=<SHORTCUT_FORGE_OUT> -- uvx shortcut-forgeReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from shortcut-forge <command>
Config file
{
"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>
Config file
{
"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>
Platform CLI
gemini mcp add -e SHORTCUT_FORGE_OUT=<SHORTCUT_FORGE_OUT> shortcut-forge-apple-shortcuts-mcp uvx shortcut-forgeReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from shortcut-forge <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Shortcut Forge (Apple Shortcuts MCP)
How do I install Shortcut Forge in Claude Code?
Run claude mcp add shortcut-forge -- uvx shortcut-forge. The server starts through uvx.
What does Shortcut Forge do?
It creates Apple Shortcut files from automation requests, checks them, and signs them for import on iPhone.
What does Shortcut Forge need to run?
The MCP server uses uvx. A Mac is required to sign a file for import on iPhone.