Apple Shortcuts MCP
@as2811-project
About Apple Shortcuts MCP
Extend Claude's capabilities using MCP and MacOS Shortcuts
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"Shortcuts-MCP": {
"command": "uv",
"args": [
"--directory",
"ABSOLUTE/PATH/TO/THIS/DIRECTORY",
"run",
"main.py"
],
"env": {
"GEMINI_API_KEY": "your_gemini_api_key"
}
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is Apple Shortcuts MCP?
Apple Shortcuts MCP is a server that connects Claude to macOS Shortcuts, allowing it to trigger automated workflows. It uses the Gemini API to extract ingredients from recipe videos and then adds them to a Reminders grocery list, summarizes conversations into notes, and creates calendar events.
How to use Apple Shortcuts MCP?
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.
Key features of Apple Shortcuts MCP
- 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
Use cases of Apple Shortcuts MCP
- Send a YouTube recipe URL and have ingredients added to your shopping list
- Ask Claude to summarize a long conversation and save it as a note
- Create a calendar event by describing its title, start, and end times
- Combine ingredient extraction with a calendar reminder for meal prep
FAQ from Apple Shortcuts MCP
What Apple Shortcuts are required?
Three shortcuts must be installed from iCloud: "Add to Groceries list", "Summarise and create note", and "Calendar". Links are provided in the README.
What dependencies are needed?
Python, uv, and the google-genai Python package. Ensure you have macOS with the Reminders app and a "Groceries" list set up.
How do I configure the server?
Add the MCP server block to claude_desktop_config.json with the correct absolute path and your Gemini API key in the env section.
Can I use the shortcuts individually?
Yes, you can ask Claude to get ingredients first, then separately add them to the list or create a calendar event.
Where does the data live?
All data stays on your Mac. The server interacts with local apps (Reminders, Notes, Calendar) and the Gemini API for video understanding.
Frequently asked questions
What Apple Shortcuts are required?
Three shortcuts must be installed from iCloud: "Add to Groceries list", "Summarise and create note", and "Calendar". Links are provided in the README.
What dependencies are needed?
Python, `uv`, and the `google-genai` Python package. Ensure you have macOS with the Reminders app and a "Groceries" list set up.
How do I configure the server?
Add the MCP server block to `claude_desktop_config.json` with the correct absolute path and your Gemini API key in the `env` section.
Can I use the shortcuts individually?
Yes, you can ask Claude to get ingredients first, then separately add them to the list or create a calendar event.
Where does the data live?
All data stays on your Mac. The server interacts with local apps (Reminders, Notes, Calendar) and the Gemini API for video understanding.
Basic information
More Other MCP servers
Sequential Thinking
modelcontextprotocolModel Context Protocol Servers
EverArt
modelcontextprotocolModel Context Protocol Servers
IDA Pro MCP
mrexodiaAI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.
Mobile Mcp
mobile-nextModel Context Protocol Server for Mobile Automation and Scraping (iOS, Android, Emulators, Simulators and Real Devices)
ICSS
chokcoco不止于 CSS
Comments