README Documentation
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:
brew install mise
For more information about mise, visit the official documentation.
Quick install
Manual installation
Update your MCP configuration with the following server:
{
"mcpServers": {
"shortcuts-mcp-server": {
"command": "mise",
"args": [
"x",
"ubi:artemnovichkov/shortcuts-mcp-server@latest",
"--",
"shortcuts-mcp-server"
]
}
}
}
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
Quick Install
Quick Actions
Key Features
Model Context Protocol
Secure Communication
Real-time Updates
Open Source