How do I install the Mealie skill?

Run npx skillmds@latest add modbender/mealie-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Mealie safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Mealie?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Mealie free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Mealie?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Mealie by modbender — Agent Skill

Name: Mealie
Rating: 4.2 (5 reviews)
Author: modbender

File contents

Mealie Skill

API client for Mealie, a self-hosted recipe manager and meal planner. Manage recipes, shopping lists, and meal plans.

Environment Variables

Set these in your agent's .env (~/.openclaw/.env) or create a skill-level .env at ~/.openclaw/skills/mealie/.env:

MEALIE_URL — Your Mealie instance URL (e.g., https://recipes.example.com)
MEALIE_API_TOKEN — Your API token (create at /user/profile/api-tokens in Mealie)

The script only reads MEALIE_URL and MEALIE_API_TOKEN from .env files — other variables are ignored.

Getting an API Token

Log into your Mealie instance
Go to User Profile → API Tokens
Create a new token with a descriptive name
Copy the token to your .env

Commands

Recipes

node ~/.openclaw/skills/mealie/scripts/mealie.js recipes              # List all recipes
node ~/.openclaw/skills/mealie/scripts/mealie.js recipe <slug>        # Get recipe details
node ~/.openclaw/skills/mealie/scripts/mealie.js search "query"       # Search recipes
node ~/.openclaw/skills/mealie.js create-recipe <url>                 # Import recipe from URL
node ~/.openclaw/skills/mealie.js delete-recipe <slug>                # Delete recipe

Shopping Lists

node ~/.openclaw/skills/mealie/scripts/mealie.js lists                # List shopping lists
node ~/.openclaw/skills/mealie.js list <id>                           # Show list items
node ~/.openclaw/skills/mealie.js add-item <listId> "item" [qty]      # Add item
node ~/.openclaw/skills/mealie.js check-item <listId> <itemId>        # Mark checked
node ~/.openclaw/skills/mealie.js uncheck-item <listId> <itemId>      # Mark unchecked
node ~/.openclaw/skills/mealie.js delete-item <listId> <itemId>       # Delete item

Meal Plans

node ~/.openclaw/skills/mealie/scripts/mealie.js mealplan [days]      # Show meal plan (default 7 days)
node ~/.openclaw/skills/mealie.js add-meal <date> <recipeSlug> [meal] # Add meal to plan
node ~/.openclaw/skills/mealie.js delete-meal <planId>                # Remove meal from plan

Other

node ~/.openclaw/skills/mealie.js stats                               # Show statistics
node ~/.openclaw/skills/mealie.js tags                                # List all tags
node ~/.openclaw/skills/mealie.js categories                          # List all categories

Examples

# List all recipes
node ~/.openclaw/skills/mealie/scripts/mealie.js recipes

# Search for pasta recipes
node ~/.openclaw/skills/mealie/scripts/mealie.js search "pasta"

# Get a specific recipe
node ~/.openclaw/skills/mealie/scripts/mealie.js recipe spaghetti-carbonara

# Add milk to shopping list
node ~/.openclaw/skills/mealie/scripts/mealie.js add-item abc123 "Milk" "1 gallon"

# Show this week's meal plan
node ~/.openclaw/skills/mealie/scripts/mealie.js mealplan 7

# Add a recipe to Tuesday's dinner
node ~/.openclaw/skills/mealie/scripts/mealie.js add-meal 2026-02-17 chicken-tacos dinner

API Details

Uses Bearer token authentication
All endpoints are under /api/
Pagination is supported on list endpoints (use --page and --per-page flags)
Recipe slugs are URL-friendly identifiers (e.g., spaghetti-carbonara)

Based on Mealie API docs.

---name: mealie-2description: Interact with Mealie recipe manager (recipes, shopping lists, meal plans). Self-hosted recipe and meal planning API client.---# Mealie SkillAPI client for [Mealie](https://mealie.io), a self-hosted recipe manager and meal planner. Manage recipes, shopping lists, and meal plans.## Environment VariablesSet these in your agent's `.env` (`~/.openclaw/.env`) or create a skill-level `.env` at `~/.openclaw/skills/mealie/.env`:- `MEALIE_URL` — Your Mealie instance URL (e.g., `https://recipes.example.com`)- `MEALIE_API_TOKEN` — Your API token (create at `/user/profile/api-tokens` in Mealie)The script only reads `MEALIE_URL` and `MEALIE_API_TOKEN` from `.env` files — other variables are ignored.## Getting an API Token1. Log into your Mealie instance2. Go to User Profile → API Tokens3. Create a new token with a descriptive name4. Copy the token to your `.env`## Commands### Recipes```bashnode ~/.openclaw/skills/mealie/scripts/mealie.js recipes # List all recipesnode ~/.openclaw/skills/mealie/scripts/mealie.js recipe <slug> # Get recipe detailsnode ~/.openclaw/skills/mealie/scripts/mealie.js search "query" # Search recipesnode ~/.openclaw/skills/mealie.js create-recipe <url> # Import recipe from URLnode ~/.openclaw/skills/mealie.js delete-recipe <slug> # Delete recipe```### Shopping Lists```bashnode ~/.openclaw/skills/mealie/scripts/mealie.js lists # List shopping listsnode ~/.openclaw/skills/mealie.js list <id> # Show list itemsnode ~/.openclaw/skills/mealie.js add-item <listId> "item" [qty] # Add itemnode ~/.openclaw/skills/mealie.js check-item <listId> <itemId> # Mark checkednode ~/.openclaw/skills/mealie.js uncheck-item <listId> <itemId> # Mark uncheckednode ~/.openclaw/skills/mealie.js delete-item <listId> <itemId> # Delete item```### Meal Plans```bashnode ~/.openclaw/skills/mealie/scripts/mealie.js mealplan [days] # Show meal plan (default 7 days)node ~/.openclaw/skills/mealie.js add-meal <date> <recipeSlug> [meal] # Add meal to plannode ~/.openclaw/skills/mealie.js delete-meal <planId> # Remove meal from plan```### Other```bashnode ~/.openclaw/skills/mealie.js stats # Show statisticsnode ~/.openclaw/skills/mealie.js tags # List all tagsnode ~/.openclaw/skills/mealie.js categories # List all categories```## Examples```bash# List all recipesnode ~/.openclaw/skills/mealie/scripts/mealie.js recipes# Search for pasta recipesnode ~/.openclaw/skills/mealie/scripts/mealie.js search "pasta"# Get a specific recipenode ~/.openclaw/skills/mealie/scripts/mealie.js recipe spaghetti-carbonara# Add milk to shopping listnode ~/.openclaw/skills/mealie/scripts/mealie.js add-item abc123 "Milk" "1 gallon"# Show this week's meal plannode ~/.openclaw/skills/mealie/scripts/mealie.js mealplan 7# Add a recipe to Tuesday's dinnernode ~/.openclaw/skills/mealie/scripts/mealie.js add-meal 2026-02-17 chicken-tacos dinner```## API Details- Uses Bearer token authentication- All endpoints are under `/api/`- Pagination is supported on list endpoints (use `--page` and `--per-page` flags)- Recipe slugs are URL-friendly identifiers (e.g., `spaghetti-carbonara`)Based on [Mealie API docs](https://docs.mealie.io).

Frequently asked questions

Mealie