mealie

What This Skill Does

The Mealie skill for OpenClaw provides a powerful, command-line interface for your personal Mealie instance. It acts as a bridge between your AI agent and your self-hosted kitchen management system. Whether you are tracking dietary needs, managing grocery supplies, or planning your weekly meals, this skill allows for automated, hands-free management of your recipe database. It bridges the gap between digital recipe storage and active kitchen logistics by allowing the AI to search, retrieve, import, and organize your culinary data effortlessly.

Installation

To integrate this skill, ensure you have the OpenClaw environment configured. Run the command clawhub install openclaw/skills/skills/angusthefuzz/mealie-api to pull the necessary scripts. Once installed, locate the ~/.openclaw/skills/mealie/.env file. You must provide the MEALIE_URL for your server and a valid MEALIE_API_TOKEN generated from your Mealie User Profile settings. The agent will read these credentials to authenticate against your secure instance.

Use Cases

This skill is perfect for users who want to automate meal preparation. Use it to quickly import recipes from URLs while browsing, search for dinner inspiration based on ingredients you already have, or add items to your shopping list as you run out of them. It is also highly effective for long-term meal planning, allowing you to schedule specific recipes for specific dates, ensuring you have a structured nutrition plan for the week ahead without manually logging into the web interface.

Example Prompts

1. "Search for a healthy pasta recipe in my Mealie collection and show me the ingredients."
2. "Add two liters of milk and a loaf of bread to my primary shopping list."
3. "What does my meal plan look like for the next three days?"

Tips & Limitations

Always ensure your API token has sufficient permissions to modify data if you intend to use write commands like add-item or create-recipe. Note that the script performs direct API calls, so if your Mealie instance is behind a VPN or firewall, the agent must have network access to reach the server. For the best experience, keep your recipe slugs clean and descriptive, as these are used for direct lookups in the command line. If you encounter connectivity errors, verify your MEALIE_URL does not have a trailing slash.