Apple Shortcuts · jonathanrreed — Claude Code MCP server: install
This MCP server lets an agent list, inspect, and run Apple Shortcuts on macOS. Use it when a coding client needs to trigger existing Mac workflows.
claude mcp add --env APPLE_SHORTCUTS_MCP_SAFETY_MODE=<APPLE_SHORTCUTS_MCP_SAFETY_MODE> --transport stdio appleshortcuts-mcp -- uvx apple-shortcuts-mcpWhat Apple Shortcuts does
Apple Shortcuts exposes the Shortcuts library through MCP. An agent can discover available shortcuts, inspect a chosen shortcut, and run it on the Mac instead of handling each action manually.
You need macOS, Python 3.11+, and uv for the setup. Register the server in Claude Code and restart the client afterward. The server will not run without macOS.
Set APPLE_SHORTCUTS_MCP_SAFETY_MODE when the client configuration needs an explicit safety profile. Shortcuts usually does not show a separate permission prompt; shortcuts_health can check the connection state. Returned data may still be sent from the MCP client to its model provider.
What it helps with
- list available Apple Shortcuts
- inspect a shortcut before running it
- trigger a Mac shortcut from an agent chat
- check the Shortcuts connection
Example prompts for the agent
- List the Apple Shortcuts available on this Mac.
- Inspect the “Morning Report” shortcut and explain what it does.
- Run the “Create Invoice” shortcut and report the result.
How to install Apple Shortcuts
Platform CLI
claude mcp add --env APPLE_SHORTCUTS_MCP_SAFETY_MODE=<APPLE_SHORTCUTS_MCP_SAFETY_MODE> --transport stdio appleshortcuts-mcp -- uvx apple-shortcuts-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from apple-shortcuts-mcp <command>
Platform CLI
codex mcp add appleshortcuts-mcp --env APPLE_SHORTCUTS_MCP_SAFETY_MODE=<APPLE_SHORTCUTS_MCP_SAFETY_MODE> -- uvx apple-shortcuts-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from apple-shortcuts-mcp <command>
Config file
{
"mcpServers": {
"appleshortcuts-mcp": {
"command": "uvx",
"args": [
"apple-shortcuts-mcp"
],
"env": {
"APPLE_SHORTCUTS_MCP_SAFETY_MODE": "<APPLE_SHORTCUTS_MCP_SAFETY_MODE>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from apple-shortcuts-mcp <command>
Config file
{
"servers": {
"appleshortcuts-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"apple-shortcuts-mcp"
],
"env": {
"APPLE_SHORTCUTS_MCP_SAFETY_MODE": "<APPLE_SHORTCUTS_MCP_SAFETY_MODE>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from apple-shortcuts-mcp <command>
Platform CLI
gemini mcp add -e APPLE_SHORTCUTS_MCP_SAFETY_MODE=<APPLE_SHORTCUTS_MCP_SAFETY_MODE> appleshortcuts-mcp uvx apple-shortcuts-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from apple-shortcuts-mcp <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 Apple Shortcuts
How do I install Apple Shortcuts in Claude Code?
Install uv, then run claude mcp add apple-shortcuts-mcp -- uvx apple-shortcuts-mcp. Restart Claude Code after installation.
What does Apple Shortcuts do?
It gives an MCP client access to Apple Shortcuts on macOS, including discovery, inspection, and execution.
What does Apple Shortcuts require?
The server requires macOS and Python 3.11+. It runs through uvx, and its safety profile can be set with APPLE_SHORTCUTS_MCP_SAFETY_MODE.
Similar MCP servers
All MCP servers for Automation and no-code: n8n, Zapier, Make →Apple Shortcuts by other authors comes first.
