https://github.com/hawkinslabdev/mealie-planner

A simple self-hosted kitchen planner for Mealie. Supports Home Assistant.
https://github.com/hawkinslabdev/mealie-planner

addon app calendar food home-assistant home-assistant-app homeassistant mealie ocr planner recipe recipes

Last synced: 3 days ago
JSON representation

A simple self-hosted kitchen planner for Mealie. Supports Home Assistant.

• Host: GitHub
• URL: https://github.com/hawkinslabdev/mealie-planner
• Owner: hawkinslabdev
• License: agpl-3.0
• Created: 2026-05-13T15:08:46.000Z (about 1 month ago)
• Default Branch: main
• Last Pushed: 2026-05-31T09:09:59.000Z (20 days ago)
• Last Synced: 2026-05-31T11:07:30.543Z (20 days ago)
• Topics: addon, app, calendar, food, home-assistant, home-assistant-app, homeassistant, mealie, ocr, planner, recipe, recipes
• Language: Python
• Homepage:
• Size: 1.29 MB
• Stars: 32
• Watchers: 0
• Forks: 1
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Mealie Planner

[![License](https://img.shields.io/badge/license-AGPL%203.0-blue)](LICENSE)

[![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/hawkinslabdev/mealie-planner/.github%2Fworkflows%2Fbuild-container.yml)](#)

[![GitHub Tag](https://img.shields.io/github/v/tag/hawkinslabdev/mealie-planner?label=version)](https://github.com/hawkinslabdev/mealie-planner/blob/main/mealie-planner/CHANGELOG.md)

[![Add to Home Assistant](https://img.shields.io/badge/Home%20Assistant-Install%20App-03a9f4?logo=homeassistant)](https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2Fhawkinslabdev%2Fmealie-planner%2F)

[![Support](https://img.shields.io/badge/Support-Buy%20me%20a%20coffee-fdd734?logo=buy-me-a-coffee)](https://coff.ee/hawkinslabdev)

Mealie Planner is a self-hosted week-view meal planner for [Mealie](https://mealie.io). Browse your recipe library, drag meals onto your week grid, and let the sparkle feature suggest random dishes. Enable the quick-add feature to import recipes from video, web page or image.



We want to make it incredibly simple to plan your meals for the week ahead. Manage your weekly meal plans with Mealie Planner. Share access and use the week-at-a-glance view. All in your native language.

## Installation

### Home Assistant

[![Open your Home Assistant instance and show the add app repository dialog with a specific repository URL pre-filled.](https://my.home-assistant.io/badges/supervisor_add_addon_repository.svg)](https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2Fhawkinslabdev%2Fmealie-planner%2F)

1. In Home Assistant, go to **Settings → Apps** and select **Install app**

2. Click **⋮ → Repositories**

3. Paste `https://github.com/hawkinslabdev/mealie-planner` and click **Add**

4. Search for **Mealie Planner**, select it, and click **Install**

When that's done then start the app, and enter your Mealie instance and [API key](https://docs.mealie.io/documentation/getting-started/api-usage/#getting-a-token).

### Docker Compose

```yaml

services:

  mealie-planner:

    image: ghcr.io/hawkinslabdev/mealie-planner:latest

    ports:

      - "3000:3000"

    volumes:

      - ./data:/app/data

    environment:

      - MEALIE_API_URL=https://mealie.yourdomain.com

      - MEALIE_API_KEY=your-api-key-here

      # Optional and absolutely not necessary:

      - PIN_CODE=ABC123

    restart: unless-stopped

```

After starting the container, the application will be available at `http://localhost:3000`. 

## License

This project is licensed under the **AGPL 3.0** license. See [LICENSE](LICENSE) for details. This project is not affiliated with [Mealie](https://mealie.io).

## Contributing

Contributions including ideas, bug reports, and pull requests are welcome. Please open an issue to discuss any proposed changes or identified issues.