Shortcuts
About
Access and run Apple Shortcuts. Allows AI assistants to list, view, and execute your shortcuts.
Details
- Author
- artemnovichkov
- GitHub stars
- 29
- Downloads
- 353
- Categories
- Productivity, Other
Jump to
- Run a shortcut by name.
- List all shortcuts, with optional identifiers.
- View a shortcut in the Shortcuts app.
- Supports Prompts and Resources in compatible clients.
- Native integration with Apple Shortcuts on macOS.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
ShortcutsCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install the server using mise (prerequisite) or by adding the manual configuration shown in the README. Once configured, simply ask an LLM to run a shortcut, show a list of added shortcuts, or view a shortcut in the Shortcuts app.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"shortcuts": {
"shortcuts-mcp-server": {
"type": "stdio",
"command": "/absolute/path/to/shortcuts-mcp-server/.build/arm64-apple-macosx/debug/shortcuts-mcp-server"
}
}
}
}McpServers
{
"shortcuts-mcp-server": {
"type": "stdio",
"command": "/absolute/path/to/shortcuts-mcp-server/.build/arm64-apple-macosx/debug/shortcuts-mcp-server"
}
}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
- Run shortcuts from the command line
- List of helpful links for shortcuts information
- Shortcuts Library
- Shortcuts Directory
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
