MCP.so
Sign In

Apple Shortcuts MCP

@as2811-project

Repository

About Apple Shortcuts MCP

Extend Claude's capabilities using MCP and MacOS Shortcuts

#apple#mcp#gemini#shortcuts-app#mcp-server

Basic information

Category

Other

License

MIT license

Runtime

python

Transports

stdio

Publisher

as2811-project

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.

Comments

More Other MCP servers

Servers

modelcontextprotocol

Model Context Protocol Servers

88.2K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Mcp

browsermcp

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K

Nginx UI

0xJacky

Yet another WebUI for Nginx

11.3K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K