A powerful API client for Mealie that lets you manage recipes, meal plans, and shopping lists through AI-driven workflows.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install mealie-api
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install mealie-api using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Mealie?
Mealie is a premier self-hosted recipe management solution designed for food enthusiasts who prefer to own their data. This skill connects your AI agent directly to your instance, enabling a fluid interface for searching, importing, and organizing recipes. By using Openclaw Skills, you can turn a simple recipe database into an intelligent kitchen assistant.
Whether you are looking for a quick pasta dish or organizing a full month of dinner plans, this integration streamlines the process. It handles everything from recipe discovery to shopping list synchronization, ensuring your kitchen stays as organized as your code.
Mealie Use Cases
- Search your recipe library using natural language queries through your AI agent.
- Import new recipes instantly just by providing a URL.
- Generate and view weekly meal plans to stay on track with dietary goals.
- Update and manage shopping list items while planning meals or checking inventory.
- Access global kitchen statistics and tags within Openclaw Skills.
How Mealie Works
- The skill initializes using Node.js and connects to your private Mealie instance via the provided URL.
- Authentication is handled securely using a Bearer API token configured in your environment files.
- User commands for recipes, lists, or plans are mapped to specific REST API endpoints.
- The skill retrieves or modifies data, supporting advanced features like pagination for large collections.
- Responses are formatted for the Openclaw Skills interface, providing clear feedback on every action.
Mealie Setup
To get started, ensure Node.js is installed on your system. You will need to generate an API token from your Mealie profile (User Profile -> API Tokens).
Configure your environment variables in ~/.openclaw/skills/mealie/.env:
MEALIE_URL="https://recipes.yourdomain.com"
MEALIE_API_TOKEN="your_generated_api_token"
Verify the installation by running the stats command:
node ~/.openclaw/skills/mealie/scripts/mealie.js stats
Mealie Data Schema & Taxonomy
The skill maps closely to the Mealie API schema, organizing data into several key pillars:
| Entity | Details |
|---|---|
| Recipes | Organized by slug, including metadata like tags, categories, and source URLs. |
| Shopping Lists | Itemized lists containing names, quantities, and completion status. |
| Meal Plans | Calendar-based entries linking specific dates and meal types to recipe slugs. |
| Taxonomy | Global tags and categories used for filtering and searching. |
Mealie Advanced Features
- Automated recipe import from web URLs using the Mealie parsing engine.
- Full support for shopping list management including checking and unchecking items.
- Flexible meal planning that supports specific meal types like breakfast, lunch, or dinner.
- Search capabilities that leverage your instance full-text indexing.
- Extensive CLI-based statistics for monitoring your recipe collection within the Openclaw Skills environment.
SKILL.md
Loading
Related Openclaw Skills
Crawl4AI Web Scraper
A powerful web scraping skill for AI agents that leverages local Crawl4AI instances to extract full-page content with JavaScript rendering.
Cozi Family Organizer
A powerful integration that allows AI agents to interact directly with the Cozi Family Organizer for managing shared schedules and lists.
Agent Earth
Agent Earth allows AI agents to perform virtual city walks by researching landmarks, generating rich waypoint data, and publishing results to a global platform.
Knowledge Forge
Knowledge Forge transforms raw experience into transferable cognitive assets and structured models that others can immediately apply.
PMC Harvest
A specialized utility for searching and harvesting full-text scientific articles and metadata from PubMed Central using official NCBI APIs.
Ragflow API Client
A universal API client for managing knowledge bases and performing Retrieval-Augmented Generation (RAG) within self-hosted Ragflow instances.
Featured*
