Apple Shortcuts MCP Server

@as2811-project

Repository

Basic information

About Apple Shortcuts MCP Server

Extend Claude's capabilities using MCP and MacOS Shortcuts

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

Apple Shortcuts MCP Server 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"
      }
    }
  }
}

Apple Shortcuts MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

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.

Comments

More Other MCP servers

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one