plan2meal

What This Skill Does

The Plan2Meal skill provides a comprehensive bridge between the OpenClaw agent and the Plan2Meal recipe management platform. It allows users to orchestrate their entire cooking workflow—from recipe discovery and storage to grocery list generation—directly through natural language chat. By integrating with the Plan2Meal API, the skill facilitates seamless CRUD operations for recipes (add, list, show, delete) and grocery lists, ensuring your meal planning remains synchronized across devices. Crucially, this skill includes built-in security transparency, ensuring that users are always informed about data routing to configured backends such as the shared Convex instance or self-hosted alternatives.

Installation

To integrate Plan2Meal into your OpenClaw environment, execute the following command in your terminal: clawdhub install openclaw/skills/skills/okikesolutions/plan2meal After installation, navigate to your project root and copy the example environment file: cp .env.example .env. You must define your CONVEX_URL to point to your specific backend instance. If you intend to use the shared backend, set ALLOW_DEFAULT_BACKEND=true. Additionally, configure your OAuth provider credentials (GitHub, Google, or Apple) and the CLAWDBOT_URL to ensure the authentication handshake completes successfully.

Use Cases

This skill is designed for users who want to centralize their cooking data. It is ideal for:

• Saving online recipes instantly: Simply provide a URL, and the agent scrapes and stores the data.
• Streamlining grocery shopping: Effortlessly move ingredients from a specific recipe into a structured grocery list.
• Organized meal planning: Search through your saved repository to find specific dishes by name or keyword without navigating browser tabs.
• Multi-system synchronization: Maintaining a single source of truth for both your library of recipes and your active shopping needs.

Example Prompts

• "Plan2Meal, please save this recipe: https://example.com/taco-night-recipe"
• "Find all my saved Italian recipes and add the ingredients for the lasagna to my 'Weekly Groceries' list."
• "What recipes do I have in my Plan2Meal account, and can you show me the details for the one with ID 402?"

Tips & Limitations

Always verify the ALLOW_DEFAULT_BACKEND setting before performing sensitive operations if you are security-conscious. The skill performs network requests to an external API; therefore, it will not function without an active internet connection or properly configured OAuth credentials. This tool is strictly for Plan2Meal management and should not be used as a general-purpose nutrition calculator or a replacement for native system reminder apps like Apple Reminders. If you encounter authentication errors, use the plan2meal login command to refresh your session tokens.