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 photo, tomorrow, shopping counts, a week overview, and a calendar show up as entities you can put on any dashboard.

GitHub / HACS repo Sign in to get a token
  • HACS custom repository
  • Read-only token
  • Free on every plan
Weekly dinner calendar for a household dashboard

Install in three steps

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

1

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.

2

Download & restart

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

3

Paste your token

Create a token in Account → Settings → Home Assistant and paste it. On this development site, set the URL to https://mydinnerplan.com.

Open GitHub repo Download zip instead

What it adds

A myDinnerPlan device with sensors, photos, and a week calendar

Tonight & tomorrow

Recipe name, who’s eating, ingredients, steps, and meal links.

Recipe photos

Picture-entity images for tonight and tomorrow, plus sensor entity pictures.

Week calendar

All-day events with meal links and photo URLs, plus a week summary sensor.

Tip: use a Picture entity card for the tonight photo, an Entities card for the sensors, and a Calendar card for the week. Updating via HACS? Download the new version, restart, then reload the integration.

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
          - 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
        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_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