Apple Shortcuts
About
Trigger shortcuts and automate tasks on macOS in a safe and controlled way.
Details
- Author
- recursechat
- Repository
- recursechat/mcp-server-apple-shortcuts
- GitHub stars
- 131
- Downloads
- 48
- License
- Apache License 2.0
- Categories
- Productivity, Community, Other
Jump to
- Lists all available Apple Shortcuts on macOS
- Runs shortcuts by name with optional input parameters
- Simple MCP-based integration with Claude Desktop
- No persistent data storage required
- Open source under Apache-2.0 license
Setting up with Highlight
Follow these steps to add this server as a custom Highlight plugin:
- 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
Apple ShortcutsCommand (node, npx, python, etc.)npxArguments-
Argument 1
-y -
Argument 2
mcp-server-apple-shortcuts
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Here's the Claude Desktop configuration to use the Apple Shortcuts server:
{
"mcpServers": {
"apple-shortcuts": {
"command": "npx",
"args": ["-y", "mcp-server-apple-shortcuts"]
}
}
}
You can ask Claude "list shortcuts" or run a specific shortcut with the shortcut name, for example "get word of the day" or "play a song".
list_shortcuts
Lists all available shortcuts that can be triggered by the AI assistant.
run_shortcut
Runs a specific shortcut by name. Parameters: shortcut_name (string), input_parameters (optional object).
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"apple shortcuts": {
"cwd": null,
"env": {},
"args": [
"-y",
"mcp-server-apple-shortcuts"
],
"shell": false,
"command": "npx"
}
}
}Linux
{
"cwd": null,
"env": [],
"args": [
"-y",
"mcp-server-apple-shortcuts"
],
"shell": false,
"command": "npx"
}Macos
{
"cwd": null,
"env": [],
"args": [
"-y",
"mcp-server-apple-shortcuts"
],
"shell": false,
"command": "npx"
}Windows
{
"cwd": null,
"env": [],
"args": [
"/c",
"npx",
"-y",
"mcp-server-apple-shortcuts"
],
"shell": false,
"command": "cmd"
}Apple Shortcuts MCP Server 🤖
A Model Context Protocol (MCP) server that lets AI assistants like Claude control Apple Shortcuts automations. This enables AI models to trigger shortcuts and automate tasks on macOS in a safe and controlled way.
<a href="https://www.npmjs.com/package/mcp-server-apple-shortcuts">
<a href="https://glama.ai/mcp/servers/15z6abk6p2"></a>
What is MCP? 🤔
The Model Context Protocol (MCP) is a system that lets AI apps, like Claude Desktop, connect to external tools and data sources. It gives a clear and safe way for AI assistants to work with local services and APIs while keeping the user in control.
What does this server do? 🚀
The Apple Shortcuts MCP server:
- Enables AI assistants to list available shortcuts
- Allows running shortcuts by name with optional input parameters
- Provides a simple interface for automation control
Prerequisites 📋
Before you begin, ensure you have:
- Node.js (v18 or higher)
- Claude Desktop installed
- macOS with Shortcuts app configured
Configuration to use Apple Shortcuts Server ⚙️
Here's the Claude Desktop configuration to use the Apple Shortcuts server:
{
"mcpServers": {
"apple-shortcuts": {
"command": "npx",
"args": ["-y", "mcp-server-apple-shortcuts"]
}
}
}
Build Apple Shortcuts Server and run locally 🛠️
1. Clone this repository:
git clone git@github.com:recursechat/mcp-server-apple-shortcuts.git
2. Install dependencies:
npm install
3. Build project
npm run build
Here's the Claude Desktop configuration to use the Apple Shortcuts server with a local build:
{
"mcpServers": {
"apple-shortcuts": {
"command": "npx",
"args": ["/path/to/mcp-server-apple-shortcuts/build/index.js"],
}
}
}
<!--
{
"mcpServers": {
"apple-shortcuts": {
"command": "npx",
"args": ["-y", "mcp-server-apple-shortcuts"]
}
}
}
-->
Usage 🎯
You can ask Claude "list shortcuts" or run a specific shortcut with the shortcut name, for example "get word of the day" or "play a song".
License ⚖️
Apache-2.0
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
