← Back to directory

Rohlik MCP Server

Community

Enhance your LLM with the ability to buy groceries at Rohlik Group platforms.

GitHub source repository ↗

★ 118 Stars Category · Other Popular Source revision 9e824c5b1dba

47FMRS · D

Reliability

5/20

Security and permissions

6/20

Maintenance

12/20

Documentation

13/20

Setup experience

11/20

The Rohlik MCP server offers a comprehensive set of tools for AI-assisted grocery shopping across multiple European platforms. It emphasizes convenience and smart shopping, but it is intended for personal use only due to reliance on reverse-engineered APIs and the risks associated with real purchases and credential exposure. Installation is straightforward with clear configuration for Claude Desktop, and it includes debugging and validation tools.

Read the FMRS scoring method →

The Rohlik MCP server is a Model Context Protocol implementation that enables AI assistants to interact with the Rohlik Group's online grocery delivery services across multiple countries. It provides tools for searching products, managing shopping carts, and accessing account information. Supports Rohlik.cz (Czech Republic), Knuspr.de (Germany), Gurkerl.at (Austria), Kifli.hu (Hungary), and Sezamo.ro (Romania). For personal use only, based on reverse-engineered API.

Tools

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.

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.

get_discounted_items

Browse currently discounted items, optionally filtered by food category, with sorting and pagination.

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.

get_delivery_info

Get current delivery information and fees.

get_delivery_slots

View available delivery time slots for your address.

get_premium_info

Check your Rohlik Premium subscription status and benefits.

get_announcements

View current announcements and notifications.

get_reusable_bags_info

Track your reusable bags and environmental impact.

Setup

Ensure Node.js and npm are installed.
Add the MCP server configuration to your Claude Desktop config file (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json; Windows: %APPDATA%/Claude/claude_desktop_config.json), providing your Rohlik credentials and the desired ROHLIK_BASE_URL (e.g., https://www.rohlik.cz).
Restart Claude Desktop.

claude_desktop_config.json

{
  "mcpServers": {
    "rohlik": {
      "command": "npx",
      "args": [
        "-y",
        "@tomaspavlin/rohlik-mcp"
      ],
      "env": {
        "ROHLIK_USERNAME": "[email protected]",
        "ROHLIK_PASSWORD": "your-password",
        "ROHLIK_BASE_URL": "https://www.rohlik.cz"
      }
    }
  }
}

Generate and validate client config

Fit and risk

Best for

Users who want to use AI assistants to buy groceries on Rohlik Group platforms (Czech Republic, Germany, Austria, Hungary, Romania).
Individuals looking to automate shopping list management or get personalized food suggestions.
Personal use, accepting the unofficial API for study or research purposes.

Not for

Commercial use or large-scale automation.
Production environments requiring official support or stability.
Users without a Rohlik account or unwilling to provide credentials.
Unsupported countries (Italy, Spain are planned).

Required permissions

Requires your Rohlik username and password for login.
Can access your account information, including order history, delivery details, and cart.
Can modify your shopping cart (add/remove items).
May place orders on your behalf if instructed by the LLM.

Risks and side effects

Use of reverse-engineered API violates terms of service, potentially leading to account suspension.
Risk of credentials stored in plaintext in config files.
AI assistant may mistakenly add or remove items, causing unintended purchases or cancellations.
Dependence on unofficial API that may change or break at any time.

Troubleshooting

Login failed: check credentials, enable debug mode (ROHLIK_DEBUG=true), run npm run validate-api.
No order history found: ensure your account has at least one completed order.
Slow responses: reduce the number of orders analyzed for smart shopping features.
Products not found: search using partial names or verify the product exists on the website.
spawn npx ENOENT: use absolute path to npx or run with node directly.

Use cases

Regular shopping: have the LLM add ingredients for recipes or shopping list items.

Smart shopping: get personalized recommendations and frequently bought items based on order history.

Deals & discounts: explore current discounted items.

Planning: check delivery slots, upcoming orders, and order history.

Supported clients

Claude DesktopFull support

Related MCP servers

Compare with other MCP servers