Apple Shortcuts MCP
About
Extend Claude's capabilities using MCP and MacOS Shortcuts
Details
- Author
- as2811-project
- Downloads
- 300
- Categories
- Other
Jump to
- Ingredient extraction from YouTube recipe videos via Gemini
- Adds extracted ingredients to a Reminders grocery list
- Summarizes chat conversations and creates a new note
- Creates calendar events from natural language descriptions
- Daisy-chain multiple shortcuts in a single conversation
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
Apple Shortcuts MCPCommand (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 three required Apple Shortcuts from provided iCloud links, clone the repository, install uv, run uv sync and uv pip install google-genai, then configure Claude Desktop with the JSON config containing your Gemini API key. Once set up, Claude offers tools for ingredient extraction, note summarization, and calendar creation.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"apple shortcuts mcp": {
"Shortcuts-MCP": {
"command": "uv",
"args": [
"--directory",
"ABSOLUTE/PATH/TO/THIS/DIRECTORY",
"run",
"main.py"
],
"env": {
"GEMINI_API_KEY": "your_gemini_api_key"
}
}
}
}
}McpServers
{
"Shortcuts-MCP": {
"command": "uv",
"args": [
"--directory",
"ABSOLUTE/PATH/TO/THIS/DIRECTORY",
"run",
"main.py"
],
"env": {
"GEMINI_API_KEY": "your_gemini_api_key"
}
}
}Claude + MacOS Shortcuts
This is a simple MCP server that leverages the MacOS Shortcuts functionality to perform specific tasks:
1. Hit Gemini Video Understanding API to extract ingredients from a recipe (this is why I began building this in the first place)
2. Add the extracted ingredients to a list in the Reminders app (this assumes you have a "Groceries" list in your Reminders app)
3. Summarise a chat conversation and add the summary to a new note.
4. Create a calendar event
All the above functionalities require the following Shortcuts to be setup on your Mac:
1. Add to Groceries list: https://www.icloud.com/shortcuts/6f696d784722468097df8ed238f8eaf2
2. Summarise and create note: https://www.icloud.com/shortcuts/bb0d13d3790c48e5b78eb26dbc7e3aca
3. Calendar: https://www.icloud.com/shortcuts/c01969b7e92343dfa3f38caad3a08f40
After adding the shorts mentioned above, follow these steps to setup the MCP server:
1. Clone the repo
2. Install uv (brew install uv)
3. cd into the directory of this repo, run uv sync followed by uv pip install google-genai
4. Copy the Claude Config JSON specified below with your Gemini API key and update your claude_desktop_config.json file
5. Open/Reopen Claude, you should be able to see the tools now.
Config:
{
"mcpServers": {
"Shortcuts-MCP": {
"command": "uv",
"args": [
"--directory",
"ABSOLUTE/PATH/TO/THIS/DIRECTORY",
"run",
"main.py"
],
"env": {
"GEMINI_API_KEY": "your_gemini_api_key"
}
}
}
}
Usage
1. Extract ingredients and create shopping list: Simply send the URL to a recipe on YouTube and ask Claude to add the ingredients to your list.
2. Calendar: Provide some context on what the event is about, and the start and end datetime values.
You can daisy chain the usage of these tools, for example: You can ask it to simply get the ingredients first, then separately ask it to create the list and add a calendar event.
Troubleshooting
Ensure you have Python, uv and other dependencies installed. On your Mac, create a "Groceries" list in your reminders app for the Shortcut itself to work properly.
Contributing
If you have other interesting Mac Shortcuts that can be triggered via Claude/MCP, feel free to add your tool here.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
