tomaspavlin/rohlik-mcp

**Enhance your favourite LLM with capabilities to buy groceries.**
> [!WARNING]
> This MCP server is made for study purposes with use of reverse engineered Rohlik API. It is for personal use only.
This is a Model Context Protocol (MCP) server that enables AI assistants to interact with the Rohlik Group's online grocery delivery services across multiple countries. This server provides tools for searching products, managing shopping carts, and accessing account info.
**Supported Services:**
- 🇨🇿 **Rohlik.cz** - Czech Republic
- 🇩🇪 **Knuspr.de** - Germany
- 🇦🇹 **Gurkerl.at** - Austria
- 🇭🇺 **Kifli.hu** - Hungary
- 🇷🇴 **Sezamo.ro** - Romania
- 🇮🇹 **Sezamo.it** - Italy (planned)
- 🇪🇸 **Sezamo.es** - Spain (planned)
Example LLM prompts that work very well with the Rohlik MCP:
**🛒 Regular Shopping:**
- *Add ingredients for apple pie to the cart. Only gluten-free and budget-friendly.*
- *Or actually, instead of apple pie I want to make pumpkin pie. Change the ingredients.*
- *What are the items in my cart?*
- *Add the items in the attached shopping list photo to the cart.*
- *Add the bread I marked as favorite in Rohlik to my cart.*
**🤖 Smart Shopping:**
- *"Add breakfast items I typically order"*
- *"Show me lunch suggestions for this week"*
- *"What do I usually buy for dinner?"*
- *"I need snacks - suggest what I normally order"*
- *"Show my top 20 most purchased items"*
- *"What can I do with Rohlik MCP?"*
**💰 Deals & Discounts:**
- *What's on sale this week?*
**📅 Planning:**
- *What are the cheapest delivery slots for tomorrow?*
- *When is my next delivery?*
- *Show my last 5 orders*
📚 Documentation
**New to Rohlik MCP?** Check out our Complete Guide for Newcomers!
Usage
Claude Desktop Configuration
Add the MCP to Claude Desktop configuration:
- On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- On Windows: %APPDATA%/Claude/claude_desktop_config.json
Add the following configuration:
Supported Regions
The server supports multiple Rohlik regions by setting the ROHLIK_BASE_URL environment variable:
* **Czech Republic**: https://www.rohlik.cz (default)
* **Germany**: https://www.knuspr.de
* **Austria**: https://www.gurkerl.at
* **Hungary**: https://www.kifli.hu
* **Romania**: https://www.sezamo.ro
* **Italy** (planned): https://www.sezamo.it
* **Spain** (planned): https://www.sezamo.es
If ROHLIK_BASE_URL is not specified, it defaults to the Czech version.
Tools
Core Shopping
- search_products - Search for grocery products by name with filtering options
- add_to_cart - Add multiple products to your shopping cart
- get_cart_content - View current cart contents and totals
- remove_from_cart - Remove items from your shopping cart
- get_shopping_list - Retrieve shopping lists by ID
🤖 Smart Shopping
- get_meal_suggestions - Get personalized suggestions for breakfast, lunch, dinner, snacks, baking, drinks, or healthy eating based on your order history
- get_frequent_items - Analyze order history to find most frequently purchased items (overall + per category)
- get_shopping_scenarios - Interactive guide showing what you can do with the MCP
Deals & Discounts
- get_discounted_items - Browse currently discounted items (cenové trháky), optionally filtered by food category, with sorting and pagination
Getting info
- get_account_data - Get comprehensive account information including delivery details, orders, announcements, cart, and premium status
- get_order_history - View your past delivered orders with details
- get_order_detail - Get detailed information about a specific order including all products
- get_upcoming_orders - See your scheduled upcoming orders