- 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="<your‑jwt‑api‑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 <path‑to‑json>
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 <recipe‑id>
curl -s "$MEALIE_URL/api/recipes/${1}" \
-H "Authorization: Bearer $MEALIE_TOKEN" | jq '.'
;;
create-plan)
# Usage: mealie.sh create-plan <json‑payload>
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 <plan‑id>
curl -s "$MEALIE_URL/api/mealplan/${1}/shopping-list" \
-H "Authorization: Bearer $MEALIE_TOKEN" | jq '.'
;;
*)
echo "Unknown command: $cmd" >&2
exit 1
;;
esacMake it executable:
chmod +x scripts/mealie.shHow 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 <plan‑id>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.