Home Assistant integration

A plugin for
tonight’s dinner.

Add it through HACS (or a custom repository), paste a read-only token, and you’re done. Tonight’s recipe, ingredients, and steps, plus the shopping list, tomorrow, a week overview, and a calendar show up as entities and dashboard cards.

GitHub / HACS repo Sign in to get a token

HACS custom repository
Read-only token
Free on every plan

Home Assistant dashboard card showing tonight's dinner from myDinnerPlan

Install in three steps

Home Assistant polls myDinnerPlan. Nothing is pushed into your home network.

Add the repository

In HACS → ⋮ → Custom repositories, add Acscorp1/ha-mydinnerplan as category Integration. Do not use Settings → Apps / Add-ons → Repositories — that is only for add-ons, and this is an integration.

Download & restart

Search HACS for myDinnerPlan, download it, restart Home Assistant, then Settings → Devices & services → Add integration.

Paste your token

Create a token in Account → Settings → Home Assistant and paste it. Leave the URL as https://mydinnerplan.com (the default).

Open GitHub repo Download zip instead

What it adds

A myDinnerPlan device with recipe and shopping cards, photos, and a week calendar

Recipe card

Photo, servings, ingredient lines, and numbered steps for tonight or tomorrow.

Shopping list card

Quantities grouped by aisle, plus what is already on hand. Household and Pro.

To-do lists

The same shopping list, ingredients, and steps as read-only to-do entities for the built-in to-do card.

Week calendar

All-day events with meal links and photo URLs, plus recipe photos for picture cards.

After you add the integration, the recipe and shopping cards appear in the dashboard card picker. Updating via HACS? Download the new version, restart, then reload the integration.

Dashboard cards

Add these from the card picker, or paste them into a dashboard

Entity IDs differ by Home Assistant. Pick the sensors from the myDinnerPlan device. The to-do lists are read-only; check items off in myDinnerPlan.

type: custom:mydinnerplan-recipe-card
entity: sensor.mydinnerplan_dinner_tonight

type: custom:mydinnerplan-shopping-card
entity: sensor.mydinnerplan_dinner_shopping_needed

type: todo-list
entity: todo.mydinnerplan_shopping_list

Zip or YAML fallback

If you cannot use HACS or custom components

Prefer HACS with Acscorp1/ha-mydinnerplan. Otherwise download the zip into custom_components/mydinnerplan/, or paste REST sensors from Account Settings if your host blocks custom integrations:

# myDinnerPlan — YAML fallback only. Prefer the plugin for images + calendar.
rest:
  - resource: https://mydinnerplan.com/api/homeassistant
    scan_interval: 300
    headers:
      Authorization: Bearer YOUR_TOKEN
      Accept: application/json
    sensor:
      - name: Dinner tonight
        unique_id: mydinnerplan_tonight
        value_template: "{{ value_json.state }}"
        json_attributes:
          - date
          - weekday
          - has_meal
          - is_cooking
          - slot_label
          - servings
          - attending
          - accompaniments
          - recipe_url
          - recipe_image
          - meal_url
          - ingredients
          - steps
          - recipes
          - week_summary
          - week
        picture: "{{ value_json.recipe_image }}"
        icon: mdi:food
      - name: Dinner tomorrow
        unique_id: mydinnerplan_tomorrow
        value_template: "{{ value_json.tomorrow_state }}"
        json_attributes:
          - tomorrow_date
          - tomorrow_weekday
          - tomorrow_slot_label
          - tomorrow_recipe_name
          - tomorrow_recipe_image
          - tomorrow_recipe_url
          - tomorrow_meal_url
          - tomorrow_servings
          - tomorrow_attending
          - tomorrow_accompaniments
          - tomorrow_recipes
          - tomorrow_ingredients
          - tomorrow_steps
        picture: "{{ value_json.tomorrow_recipe_image }}"
        icon: mdi:calendar-arrow-right
      - name: Dinner shopping needed
        unique_id: mydinnerplan_shopping
        value_template: "{{ value_json.shopping_needed }}"
        unit_of_measurement: items
        json_attributes:
          - shopping_allowed
          - shopping_on_hand
          - shopping_items
          - shopping_list
          - shopping_url
          - shopping_range
        icon: mdi:cart-outline

Ready to add it to Home Assistant?

Add Acscorp1/ha-mydinnerplan in HACS as an Integration, restart, then paste a token from Account Settings. Need an account first? Create one free.

Open GitHub repo

A plugin for tonight’s dinner.