Easily integrate and manage your Grocy shopping list within your Home Assistant dashboard. This integration seamlessly syncs with Home Assistant's native To-Do lists, enabling you to mark items as done and remove completed entries effortlessly.
The integration now includes two major new features:
🤖 AI-Powered Shopping Suggestions:
- Smart Predictions: Analyzes your purchase history to suggest products you're likely to need
- Multi-Factor Analysis: Considers consumption patterns, purchase frequency, and seasonal trends
- Auto-Reset: Suggestions automatically refresh every hour to stay current
- Responsive Frontend: Beautiful, mobile-friendly interface with multi-language support
- Customizable Algorithm: Advanced settings to fine-tune the prediction engine
🔄 Bidirectional Sync:
- Two-Way Integration: Add items through Home Assistant todo lists and they automatically sync to Grocy
- Smart Product Matching: Intelligent search with exact and fuzzy matching (handles accents, case sensitivity)
- Auto Product Creation: When no match is found, new products are created automatically in Grocy
- Multiple Choice Handling: When multiple products match, get notifications to choose the right one
- Voice Assistant Ready: Includes multilingual voice commands (EN/FR/ES/DE) via blueprint
- Safety Features: Emergency stop/restart services and comprehensive error handling
⚠️ Early Release Notice: This integration is still under development. Expect possible bugs and instability. Please report any issues or request features here.
This integration is available in HACS. You can install it by clicking:
Or manually:
- Navigate to HACS > Integrations in Home Assistant.
- Click Explore & Add Repositories.
- Search for Grocy and select this integration.
- Click Install this repository in HACS.
- Press Install.
- Obtain your
URLandAPI keyfrom Grocy:- Navigate to "Manage API Keys" in Grocy.
- Click Add to generate a new API key.
- Copy your Grocy URL (
https://<your-grocy-url>/) and API key.
Click below to start the configuration:
Or manually:
- Go to Configuration > Integrations in Home Assistant.
- Click Add Integration.
- Search for Grocy and select this integration.
- Follow the setup instructions.
⚠️ Important: If using Grocy as a Home Assistant add-on, ensure you configure a port (e.g.,9192). Usehttps://<HA-IP>:9192with SSL enabled, orhttp://<HA-IP>:9192if SSL is disabled.
This integration provides the following sensors:
- ID:
sensor.products_shopping_list_with_grocy - Displays the total number of products in Grocy.
- Can include product details if enabled during setup.
- ID:
sensor.shopping_list_shopping_list_with_grocy - Shows the number of items in your Grocy shopping list.
- Can include product details if enabled.
- ID:
binary_sensor.updating_shopping_list_with_grocy - Indicates if the list is currently being updated.
- ID:
switch.pause_update_shopping_list_with_grocy - Temporarily pauses synchronization between Grocy and Home Assistant.
- ID:
sensor.grocy_shopping_suggestions - Purpose: Provides AI-powered shopping suggestions based on your purchase history
- Features:
- Statistical Analysis Engine: Analyzes consumption patterns, purchase frequency, and seasonal trends
- Smart Predictions: Suggests products you're likely to need based on historical data
- Auto-Reset: Suggestions automatically reset after 1 hour to maintain freshness
- Manual Control: Use the reset service to clear suggestions manually
- Intelligent State Detection: Shows "Analysis in progress..." when generating suggestions, "No analysis available" when no data exists
Attributes:
suggestions: List of suggested products with confidence scoreslast_update: Timestamp of when suggestions were last generatedstate: Number of current suggestions available
Frontend Panel: Access the shopping suggestions through the dedicated frontend panel with:
- Responsive design that adapts to mobile and desktop
- Multi-language support (English, French, Spanish)
- Real-time suggestion status updates
- Easy-to-use interface for viewing and managing suggestions
- ID:
todo.shopping_list_with_grocy_list_<list_id> - Purpose: Native Home Assistant todo lists that sync bidirectionally with Grocy
- Features:
- Two-Way Sync: Add items in HA and they appear in Grocy, mark as done in either system
- Smart Product Search: Intelligent matching with exact and fuzzy search capabilities
- Auto Product Creation: Unknown products are automatically created in Grocy with proper defaults
- Quantity Support: Parse quantities like "Milk (x2)" and handle them correctly
- Multiple Choice Notifications: When multiple products match, get notifications to choose
- Accent & Case Insensitive: Searches handle "café" matching "Cafe" automatically
Configuration: Enable bidirectional sync in the integration configuration to activate this feature.
🎤 Voice Assistant Blueprint: The integration includes a powerful voice assistant blueprint for hands-free shopping list management.
Installation:
- After installing the integration, the blueprint is automatically copied to your Home Assistant
- Go to Configuration > Blueprints > Automation
- Search for "Grocy Voice Assistant - Smart Choice Handler"
- Create a new automation from the blueprint
- Configure your conversation agent and todo entity
Supported Voice Commands:
🇫🇷 French Commands:
# Add products with quantity
"Ajoute 2 pommes à ma liste de courses"
"Mets 3 lait sur ma liste de courses"
"J'ai besoin de 5 bananes"
# Add products without quantity (defaults to 1)
"Ajoute pain à ma liste de courses"
"Mets fromage sur ma liste de courses"
"J'ai besoin de tomates"
# Choice selection (when multiple matches found)
"Choix 1" / "Le 1" / "Numéro 1" / "1"
🇺🇸 English Commands:
# Add products with quantity
"Add 2 apples to my shopping list"
"Put 3 milk on my shopping list"
"I need 5 bananas"
# Add products without quantity (defaults to 1)
"Add bread to my shopping list"
"Put cheese on my shopping list"
"I need tomatoes"
# Choice selection (when multiple matches found)
"Choice 1" / "Number 1" / "Option 1" / "1"
🇪🇸 Spanish Commands:
# Add products with quantity
"Agrega 2 manzanas a mi lista de compras"
"Pon 3 leche en mi lista de compras"
"Necesito 5 plátanos"
# Add products without quantity (defaults to 1)
"Agrega pan a mi lista de compras"
"Pon queso en mi lista de compras"
"Necesito tomates"
# Choice selection (when multiple matches found)
"Opción 1" / "Número 1" / "El 1" / "1"
🇩🇪 German Commands:
# Add products with quantity
"Füge 2 Äpfel zu meiner Einkaufsliste hinzu"
"Setze 3 Milch auf meine Einkaufsliste"
"Ich brauche 5 Bananen"
# Add products without quantity (defaults to 1)
"Füge Brot zu meiner Einkaufsliste hinzu"
"Setze Käse auf meine Einkaufsliste"
"Ich brauche Tomaten"
# Choice selection (when multiple matches found)
"Auswahl 1" / "Nummer 1" / "Die 1" / "1"
Voice Assistant Features:
- Multilingual Support: Full support for French, English, Spanish, and German
- Quantity Support: Specify quantities like "Add 3 milk" or use default quantity of 1
- Smart Choice Handling: When multiple products match, you'll get voice feedback with options
- Voice Feedback: Real-time audio responses for all operations
- Error Handling: Graceful handling of unknown products with creation options
service: shopping_list_with_grocy.suggest_grocery_list
data: {}Analyzes your purchase history and generates personalized shopping suggestions based on:
- Consumption patterns - How quickly you use products
- Purchase frequency - How often you buy specific items
- Seasonal trends - Time-based purchasing patterns
service: shopping_list_with_grocy.reset_suggestions
data: {}Manually clears all current suggestions. Useful for:
- Starting fresh analysis
- Clearing outdated suggestions
- Testing the suggestion system
service: shopping_list_with_grocy.voice_add_product_with_response
data:
product_name: "Milk"
shopping_list_id: 1 # Optional, default is 1Adds a product with voice assistant feedback. Designed for blueprint automation.
service: shopping_list_with_grocy.restart_bidirectional_sync
data: {}Emergency restart service for the bidirectional sync system in case of errors.
service: shopping_list_with_grocy.select_choice_by_number
data:
choice_number: 1
silent: false # Optional, default is falseSelects a product choice when multiple matches are found. Used internally by voice commands.
service: shopping_list_with_grocy.set_fallback_voice_response
data:
response: "Custom fallback message"Sets a fallback voice response for blueprint error handling.
service: shopping_list_with_grocy.add_product
data:
product_id: sensor.shopping_list_with_grocy_<your_product>
shopping_list_id: <shopping_list_id> # Optional, default is list 1
note: "Optional note..."service: shopping_list_with_grocy.remove_product
data:
product_id: sensor.shopping_list_with_grocy_<your_product>
shopping_list_id: <shopping_list_id> # Optional, default is list 1service: shopping_list_with_grocy.update_note
data:
product_id: sensor.shopping_list_with_grocy_<your_product>
shopping_list_id: <shopping_list_id> # Optional, default is list 1
note: "New note..."service: shopping_list_with_grocy.refresh_products
data: {}The shopping suggestions feature includes advanced configuration options for fine-tuning the prediction algorithm. Access these through the integration configuration page:
⚠️ Warning: These settings control the core algorithm. Incorrect values may break the suggestions feature. We recommend leaving defaults unchanged unless you fully understand the algorithm.
Algorithm Weights (must sum to 1.0):
- Consumption Weight (default: 0.4) - How much consumption rate affects suggestions
- Frequency Weight (default: 0.5) - How much purchase frequency affects suggestions
- Seasonal Weight (default: 0.1) - How much seasonal patterns affect suggestions
Threshold Settings:
- Score Threshold (default: 0.3) - Minimum confidence score for suggestions (0.0-1.0)
Example Advanced Configuration:
# For users who prefer frequency-based suggestions
consumption_weight: 0.3
frequency_weight: 0.5
seasonal_weight: 0.2
score_threshold: 0.65
# For seasonal shoppers
consumption_weight: 0.3
frequency_weight: 0.3
seasonal_weight: 0.4
score_threshold: 0.55You can add custom fields to your products in Grocy and use them in Home Assistant. Example: Create a Custom Sort field in Grocy:
Entity: products
Name: customsort
Caption: Custom Sort
Type: Number(decimal)
Show as column in tables: checkedThen modify your dashboard to sort using this field:
sort:
method: attribute
attribute: userfields:customsort
numeric: trueQ: Why am I seeing "Analysis in progress..." for a long time? A: The analysis requires sufficient purchase history data. Ensure you have several months of purchase data in Grocy for accurate predictions.
Q: My suggestions seem inaccurate. How can I improve them? A: Try adjusting the algorithm weights in the advanced configuration. Increase the consumption weight if you want more consumption-based suggestions, or increase frequency weight for frequency-based predictions.
Q: How often do suggestions update? A: Suggestions automatically reset after 1 hour to ensure freshness. You can also manually reset them using the reset service.
Q: Can I disable the auto-reset feature? A: The auto-reset is built-in for optimal user experience, but you can manually generate new suggestions at any time using the suggest service.
Q: The frontend panel shows "No analysis available"
A: This appears when no suggestions have been generated yet or after a reset. Run the suggest_grocery_list service to generate new suggestions.
Q: Integration not loading? A: Ensure your Grocy URL and API key are correct. Check the Home Assistant logs for detailed error messages.
Q: To-Do lists not syncing? A: Verify that your Grocy shopping lists are accessible via the API and that the integration has proper permissions.
A Lovelace card is available in HACS:
Or check it out on GitHub: Shopping List with Grocy Card
- Request new features or report issues here.
- Contribute via pull requests here.
- If you find this project useful, consider buying me a coffee ☕!