shortcuts-mcp-server
A Model Context Protocol (MCP) server that provides access to Apple Shortcuts functionality. This server allows AI assistants to list, view, and run your shortcuts through the MCP interface.
Compatible with Cursor, Claude Desktop, and other MCP-enabled applications.
Getting started
Prerequisites
- macOS 14.5 or later
- Xcode 16.x or later
- mise
Setup with mise
To install mise:
For more information about mise, visit the official documentation.
Adding to MCP clients
For project cofiguration, update .cursor/mcp.json
file in your project directory. To use across all projects, create a ~/.cursor/mcp.json
file in your home directory.
Don't forget to replace the path to the executable.
- Open Settings -> Developer -> Edit Config
- Open the config file at
~/Library/Application Support/Claude/claude_desktop_config.json
and update to:
Don't forget to replace the path to the executable.
- Restart Claude Desktop.
For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing Ctrl + Shift + P
and typing Preferences: Open User Settings (JSON)
.
Don't forget to replace the path to the executable.
Open Settings -> MCP -> Edit Config and update to:
Don't forget to replace the path to the executable.
Usage
Just ask LLM to run a shortcut, show a list of added shortcuts or view a shortcut in Shortcuts app.
If your MCP client supports Prompts and Resources you may check it as well:
Tools
- run - Run a shortcut.
name
- The name of the shortcut to run (string, required)
- list - List your shortcuts.
show-identifiers
- Whether to show the identifiers of the shortcuts. (boolean, optional)
- view - View a shortcut in Shortcuts app.
name
- Name of the shortcut to view (string, required)
Resources
- list - List your shortcuts.
Prompts
- run - Run a shortcut.
name
- Name of the shortcut to run (string, required)
- list - List your shortcuts.
show-identifiers
- Whether to show the identifiers of the shortcuts. (boolean, optional)
- view - View a shortcut in Shortcuts app.
name
- Name of the shortcut to view (string, required)
References
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
shortcuts-mcp-server
Related MCP Servers
- AsecurityAlicenseAqualityAn MCP server to run commands.Last updated -2265150TypeScriptMIT License
- -securityAlicense-qualityAn MCP Server Integration with Apple ShortcutsLast updated -27191JavaScriptApache 2.0
- Python
- PythonMIT License