Mealie API skill

---

name: mealie description: Interact with a self‑hosted Mealie instance (recipe manager & meal planner) via its REST API. Use for adding, updating, retrieving recipes, meal plans and generating shopping lists. Trigger when the user mentions their Mealie URL, wants to import a recipe, create a meal plan or fetch a shopping list.

---

Mealie Skill

When to use

The user provides a Mealie base URL (e.g., https://mealie.example.com) and/or an API token and asks to add/import a recipe, create or modify a meal plan, fetch a shopping list, or query existing recipes.

The user wants to automate meal‑planning tasks from the command line or through a script.

Required environment variables

export MEALIE_URL="https://mealie.example.com"   # base URL of the instance
export MEALIE_TOKEN=""       # bearer token obtained from Mealie UI (Settings → API Keys)

Both variables must be set in the shell where the skill runs.

Provided script

The skill bundles a small Bash helper (scripts/mealie.sh) that wraps the most common Mealie API calls using curl.

#!/usr/bin/env bash
mealie.sh – simple wrapper for Mealie REST API
Requires MEALIE_URL and MEALIE_TOKEN env vars
set -euo pipefail
cmd=$1; shift
case "$cmd" in
  add-recipe)
    # Usage: mealie.sh add-recipe 
    curl -s -X POST "$MEALIE_URL/api/recipes" \
      -H "Authorization: Bearer $MEALIE_TOKEN" \
      -H "Content-Type: application/json" \
      --data @${1}
    ;;
  get-recipe)
    # Usage: mealie.sh get-recipe 
    curl -s "$MEALIE_URL/api/recipes/${1}" \
      -H "Authorization: Bearer $MEALIE_TOKEN" | jq '.'
    ;;
  create-plan)
    # Usage: mealie.sh create-plan 
    curl -s -X POST "$MEALIE_URL/api/mealplan" \
      -H "Authorization: Bearer $MEALIE_TOKEN" \
      -H "Content-Type: application/json" \
      --data @${1}
    ;;
  get-shopping)
    # Usage: mealie.sh get-shopping 
    curl -s "$MEALIE_URL/api/mealplan/${1}/shopping-list" \
      -H "Authorization: Bearer $MEALIE_TOKEN" | jq '.'
    ;;
  *)
    echo "Unknown command: $cmd" >&2
    exit 1
    ;;
esac

Make it executable:

chmod +x scripts/mealie.sh

How to use from the chat

You can ask me to run a specific operation, e.g.:

"Add this recipe to Mealie." → I will ask you for the JSON representation of the recipe and then run scripts/mealie.sh add-recipe.

"Show me the shopping list for my current week plan." → I will call scripts/mealie.sh get-shopping and return the formatted list.

"Search for a recipe called *Spaghetti Bolognese*." → I will query the API (GET /api/recipes?search=Spaghetti%20Bolognese) and return matches.

Extending the skill

If you need additional endpoints (e.g., tags, categories, batch import), just add new case blocks to mealie.sh or create separate scripts under scripts/ and reference them in this README.

---

Note: The skill does not store the API token in any file; it relies on the environment variables you provide. Keep the token secret and rotate it regularly via the Mealie UI.