Bring your Rohlík.cz grocery deliveries into Home Assistant! Track deliveries, monitor your cart, automate shopping, and never miss a delivery window — all from your smart home dashboard.
What is Rohlík.cz?
Rohlík.cz is one of the most popular online grocery and food-delivery services in the Czech Republic (also operating as Knuspr.de in Germany, Gurkerl.at in Austria, Kifli.hu in Hungary and Sezamo.ro in Romania — all supported by this integration). They deliver fresh groceries, household goods and more — often within hours.
Warning
This integration uses a reverse-engineered API from the Rohlík.cz website. It is not officially supported by Rohlík.cz. Use it at your own risk.
Note
The current release is 1.0.0-beta4, a pre-release of the upcoming 1.0.0. It is feature-complete but still being tested — see Installing the beta below, and please report anything you run into.
- 📦 Track your next delivery — see exactly when your groceries arrive, right on your dashboard
- 🛒 Monitor your shopping cart — keep an eye on your cart total without opening the app
- ⏰ Automate delivery reminders — turn on porch lights or trigger a notification when a delivery window starts
- 🔍 Add products to cart by voice — use Home Assistant automations to add items hands-free
- 📅 Calendar view — all your delivery windows visible in the Home Assistant calendar
- 💳 Account overview — credit balance, premium status, reusable bag count, and more
- 🧩 Ready-made dashboard cards — install the companion Rohlík.cz Cards from HACS for a next-delivery card, a live shopping cart with search, delivery slots, account and spending cards
Install in one click via the Home Assistant Community Store:
Don't have HACS yet? Get it here.
HACS hides pre-releases by default, so the 1.0.0 beta will not show up until you ask for it:
- Open Rohlík.cz in HACS.
- Click ⋮ → Redownload.
- Enable Show beta versions.
- Pick
v1.0.0-beta4and download it. - Restart Home Assistant.
- Download the
rohlikczfolder from the latest release — for the beta, pick the newest release marked Pre-release. - Copy the
rohlikczfolder into your Home Assistantconfig/custom_components/directory. - Restart Home Assistant.
- Go to Settings → Devices & Services in your Home Assistant UI.
- Click Add Integration (the
+button in the bottom right). - Search for Rohlik.cz and select it.
- Pick your Shop and enter its credentials:
- Shop — Rohlík.cz, Knuspr.de, Gurkerl.at, Kifli.hu or Sezamo.ro
- Email — your account email
- Password — your account password
- Click Submit — entities will be set up automatically.
Amounts (credit, cart total, spending) are reported in the shop's currency (CZK, EUR, HUF or RON).
Note
If your password later changes or stops working, Home Assistant prompts you to re-enter it (re-authentication) instead of the integration silently failing. Each account can only be added once.
Tip
Entries created before shop selection existed point at Rohlík.cz. To move one to another shop (e.g. Knuspr.de), open the integration entry's ⋮ menu → Reconfigure and pick the shop — no need to remove and re-add it.
Note
The Delivery Time sensor reads the courier's arrival time from the shop's delivery announcement. Announcements that give a clock time work in every shop; "in N minutes" countdowns are currently only understood in Czech.
After setup you can enable Spending Analytics at any time via the integration's Configure button:
- Choose which category levels to track (top-level, mid-level, detailed, most specific, per-item)
- Set how many top items to display in sensor attributes (default: 10)
- Optionally hide discontinued products from rankings
Enabling analytics triggers a one-time download of your full order history (this may take several minutes).
| Entity | Description |
|---|---|
| Premium Membership | Active when your premium subscription is valid; premium details available as attributes |
| Reusable Bags | Active when reusable bags are enabled on your account |
| Next Order | Active when you have a scheduled upcoming order; order details as attributes |
| Timeslot Reservation | Active when you have a reserved delivery timeslot |
| Parents Club | Active when you are a member of the Parents Club |
| Express Available | Active when express delivery is currently available in your area |
| Entity | Description |
|---|---|
| First Available Delivery | Earliest available delivery time with location details |
| Account ID | Your Rohlík.cz account identifier |
| Your registered email address | |
| Phone | Your registered phone number |
| Remaining Orders Without Limit | Premium orders with no minimum price limit remaining |
| Remaining Free Express Deliveries | Free express deliveries still available |
| Credit Balance | Your current account credit (in the shop's currency) |
| Reusable Bags | Number of reusable bags on your account |
| Premium Days Remaining | Days left in your premium subscription (premium users only) |
| Cart Total | Current total value of your shopping cart; the Minimum Order Price attribute holds the shop's minimum order value (compare it with the total — Can Order also needs checkout details such as a delivery slot) |
| Last Updated | Timestamp of the last successful data refresh |
| Slot Express Time | Timestamp of the next available express delivery slot |
| Slot Standard Time | Timestamp of the nearest standard delivery slot |
| Slot Eco Time | Timestamp of the nearest eco delivery slot |
| Delivery Slot Start | Start of the delivery window for your next order |
| Delivery Slot End | End of the delivery window for your next order |
| Delivery Time | Predicted exact delivery time for your next order |
| Monthly Spent | Total amount spent this month |
| Yearly Spent | Total amount spent this year (requires Spending Analytics) |
| All Time Spent | Total spent across all tracked orders (requires Spending Analytics); the by_year attribute breaks the total down per year (total and order_count per year) |
Orders Calendar — Shows all upcoming and recent delivery windows as calendar events (entity ID typically ending in _orders_calendar, for example calendar.rohlikcz_orders_calendar; your actual ID may vary).
| Field | Value |
|---|---|
| Event Title | Order number (e.g., Order 123456789) |
| Event Start | Delivery window start time |
| Event End | Delivery window end time |
| Event Description | Order status, item count, and total price |
| State | on during an active delivery window, off otherwise |
Events are sourced from upcoming orders and the last 50 delivered orders. Events disappear automatically once an order falls outside that window.
Ideas for using the calendar:
- View all deliveries in the Home Assistant calendar UI
- Trigger automations when a delivery window starts
- Query upcoming deliveries with the
calendar.get_eventsservice
When analytics levels are enabled in the integration options, the following sensors are created (each with "this year" and "all time" variants):
- Top Categories (L0) - Spending by top-level categories (e.g. Drinks, Drugstore)
- Categories (L1) - Spending by mid-level categories (e.g. Hot drinks, Cleaning products)
- Detailed Categories (L2) - Spending by detailed categories (e.g. Coffee, Universal cleaner)
- Specific Categories (L3) - Spending by most specific categories (e.g. Bean coffee, Spray cleaner)
- Per-Item - Spending by individual product (e.g. Tchibo Barista, Savo Spray)
Each sensor's attributes contain the top N items (configurable, default 10) sorted by spending, with total_count, spent, units, and avg_unit_price per entry.
| Action | Description |
|---|---|
rohlikcz.add_to_cart |
Add a product to your cart by product ID and quantity |
rohlikcz.search_product |
Search for products available on Rohlík.cz by name |
rohlikcz.search_and_add_to_cart |
Search for a product by name and add it to your cart in one step |
rohlikcz.get_shopping_list |
Retrieve products from a saved Rohlík.cz shopping list by its ID |
rohlikcz.get_cart_content |
Get the current contents of your shopping cart |
rohlikcz.update_data |
Force an immediate full data refresh from Rohlík.cz |
rohlikcz.refresh_slots |
Cheaply refresh only the delivery-slot data with a single request — light enough to poll every few seconds to catch express availability |
rohlikcz.update_delivery_times |
Cheaply refresh only the delivery-time announcement with a single request — light enough to poll every minute to track the shifting delivery ETA |
rohlikcz.fetch_order_history |
Download your complete order history and store it locally (backfill) |
rohlikcz.enrich_orders |
Enrich stored orders with item details and product categories to populate the spending sensors |
Tip
Want a notification the moment express delivery opens up? See automations/refresh_slots.yaml for an example that polls refresh_slots every 15 seconds while armed and notifies you when the Express Available sensor turns on.
Tip
Delivery ETA shifting around before the courier arrives? See automations/update_delivery_times.yaml for an example that polls update_delivery_times every minute during the last 30 minutes before delivery so the Delivery Time sensor stays accurate.
Data is refreshed from Rohlík.cz every 10 minutes automatically. The update covers account details, premium status, delivery slots, shopping cart, and order history.
You can trigger an immediate refresh at any time using the rohlikcz.update_data action, refresh just the delivery slots more frequently with rohlikcz.refresh_slots, or refresh just the delivery-time announcement with rohlikcz.update_delivery_times.
If something isn't working, download the integration's diagnostics from Settings → Devices & Services → Rohlík.cz → ⋮ (three dots) → Download diagnostics and attach the file to your bug report. Credentials and personal details (email, phone, name, address) are automatically redacted.
Rohlík.cz Cards is a set of custom Lovelace cards built for this integration: Next Delivery (countdown, live ETA and courier announcement, plus a badge), Shopping Cart (your cart with quantity steppers, product search and an Order button), Delivery Slots (express/standard/eco with capacity and an express watch mode), Account and Spending (month, year, all-time and category breakdown). Every card only needs you to pick your Rohlík.cz device in the visual editor, speaks Czech and English, and follows your dashboard theme.
Want to do your Rohlík.cz shopping by just talking to your AI assistant? Check out the companion Rohlík MCP Server — a Model Context Protocol server that connects Rohlík.cz to AI assistants like Claude. Search products, manage your cart, find recipes, and track orders entirely through conversation. Runs as a Docker container and works alongside this integration.
- 🐛 Found a bug? Open an issue
- 💬 Have a question or idea? Use the Discussions tab
- ⭐ If you find this integration useful, consider giving the repository a star!
Disclaimer: This integration is an independent community project and is not affiliated with, endorsed by, or supported by Rohlík.cz. Changes to the Rohlík.cz platform may affect functionality.