Apple Shortcut Maker MCP

Create Apple Shortcut with AI using MCP (Model Context Protocol).

Description

An MCP server that allows AI assistants (like Claude, Cursor, etc.) to create, duplicate, list, and run Apple Shortcuts directly from code. Uses the Cherri programming language for creating shortcuts programmatically.

Features

• Create Shortcut - Create new Apple Shortcuts using Cherri code
• Duplicate Shortcut - Duplicate existing shortcuts with a new name
• List Shortcuts - List all available shortcuts on your Mac
• Run Shortcut - Run any shortcut with optional input

Requirements

• macOS Monterey or later
• Python 3.10+
• Cherri compiler installed

Installation

1. Install Cherri

brew tap electrikmilk/cherri
brew install electrikmilk/cherri/cherri

Verify Cherri is installed:

cherri --version

2. Install this MCP server

# Clone the repository
git clone https://github.com/suisei110/apple-shortcut-maker-mcp.git
cd apple-shortcut-maker-mcp

# Install as package (recommended for direct CLI usage)
uv pip install -e . --system

Or install dependencies only:

uv sync

3. Configure MCP Client

Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "Apple Shortcut Maker": {
      "command": "apple-shortcut-mcp",
      "enabled": true
    }
  }
}

Or using uv (alternative):

{
  "mcpServers": {
    "apple-shortcut-maker": {
      "command": "uv",
      "args": [
        "--directory",
        "/PATH/TO/apple-shortcut-maker-mcp",
        "run",
        "apple-shortcut-mcp"
      ]
    }
  }
}

VS Code (Cursor)

Add to your MCP settings:

{
  "mcpServers": {
    "Apple Shortcut Maker": {
      "command": "apple-shortcut-mcp",
      "enabled": true
    }
  }
}

Usage

Available Tools

Once configured, you can use these tools in your AI assistant:

1. create_shortcut

Create a new Apple Shortcut from Cherri code.

Parameters:

• code (string, required): Cherri code for the shortcut
• name (string, required): Name for the shortcut

Example:

Create a shortcut named "Hello World" that shows an alert with "Hello, World!"

2. duplicate_shortcut

Duplicate an existing shortcut with a new name.

Parameters:

• source_name (string, required): Name of the shortcut to duplicate
• new_name (string, required): Name for the new shortcut

3. list_shortcuts

List all available shortcuts on your Mac.

Parameters:

• folder (string, optional): Filter by folder name

4. run_shortcut

Run an existing shortcut.

Parameters:

• name (string, required): Name of the shortcut to run
• input (string, optional): Input to pass to the shortcut

Cherri Code Examples

Simple Alert

#define name "Hello World"
#define color blue
#define glyph star

alert("Hello, World!", "Greeting")

With Variables

#define name "Calculate"

@number1 = askNumber("Enter first number")
@number2 = askNumber("Enter second number")
@result = calculate(@number1 + @number2)

showResult("Result: {@result}")

Menu

#define name "Main Menu"

menu "Choose an option:" {
    item "Option 1":
        alert("You chose 1")
    item "Option 2":
        alert("You chose 2")
    item "Option 3":
        alert("You chose 3")
}

Troubleshooting

Cherri not found

Make sure Cherri is installed and in your PATH:

which cherri

If not found, reinstall:

brew reinstall electrikmilk/cherri/cherri

Shortcuts permission denied

Make sure Shortcuts has permission to run. Go to: System Settings > Privacy & Security > Automation

Package not found

Ensure you're using the correct Python path. The server requires Python 3.10+.

License

MIT License - see LICENSE for details.

Author

suisei110

Acknowledgments

• Cherri - Shortcuts programming language
• MCP - Model Context Protocol

---

Quick Test

After installation, you can test the MCP server directly:

cd apple-shortcut-maker-mcp
uv run apple-shortcut-mcp

You should see the server start without errors. Then configure your MCP client to use it.

Tools Available

Once configured, these tools will be available in your AI assistant:

Tool	Description
create_shortcut	Create new Apple Shortcuts from Cherri code
duplicate_shortcut	Duplicate existing shortcuts
list_shortcuts	List all available shortcuts
run_shortcut	Run existing shortcuts

Example Usage

Create a Shortcut

Create a shortcut named "Hello World" with code:
#define name "Hello World"
#define color blue
alert("Hello, World!", "Greeting")

List Shortcuts

List all shortcuts on my Mac

Run Shortcut

Run the shortcut named "My Daily Routine"