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 in Germany and Austria, and Kifli.hu in Hungary). 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.
- 📦 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
Install in one click via the Home Assistant Community Store:
Don't have HACS yet? Get it here.
- Download this repository (or just the
rohlikczfolder). - 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.
- Enter your Rohlík.cz credentials:
- Email — your Rohlík.cz account email
- Password — your Rohlík.cz account password
- Click Submit — entities will be set up automatically.
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 Rohlík.cz account can only be added once.
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 (CZK) |
| 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 |
| 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 on Rohlík.cz 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.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.
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, or refresh just the delivery slots more frequently with rohlikcz.refresh_slots.
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.
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.