M
MCP Directory CURATED DIRECTORY
911 MCP servers indexed
中文
← Back to directory
R

Rohlik MCP Server

Community
Enhance your LLM with the ability to buy groceries at Rohlik Group platforms.
How to install ↓ Compare GitHub source repository ↗
Category
Other #168 of 230
Stars
★ 121 Popular
Transport
stdio (local process)
Runtime
Node.js
Credentials
API key / credential required
License
MIT
Last commit
⚠
Tools
18
47FMRS · D

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.

Strongest · Documentation 13/20 Weakest · Reliability 5/20

Reliability
5/20
Security and permissions
6/20
Maintenance
12/20
Documentation
13/20
Setup experience
11/20
Why each score
Reliability 5/20
The server is a real TypeScript project with build and test scripts, but no CI workflow is provided, and key behaviors (MCP handshake, tool registration, API call correctness) cannot be directly verified from the repository. Tests cover only auxiliary transformation logic, not the server's core paths. Error handling is documented, but runtime depends on an external, reverse-engineered Rohlik API with limited stability and controllability. Reliability score is low.
Security and permissions 6/20
The server requires plaintext username and password stored in environment variables, which is common but exposes credentials. It communicates with the Rohlik API over HTTP, with no explicit mention of TLS enforcement or certificate validation. No confirmation mechanism exists for actions like adding items to cart or fetching order history, which may be performed inadvertently. Since the server only performs cart operations (no deletion or payment), the risk is moderate. No clear credential protection guidance (e.g., secret management) is provided, and the reverse-engineered API may carry implicit risks.
Maintenance 12/20
The repository has recent commits, 117 stars, and 4 open issues, indicating ongoing maintenance. MIT license exists, with versioning and NPM publishing workflow. However, no explicit security response channel (e.g., SECURITY.md) or dependency update policy is present. Dependency management is opaque, and the reverse-engineered API may pose maintenance challenges.
Documentation 13/20
README is very detailed: covers installation, configuration, tool descriptions, troubleshooting, debugging, and API validation usage. Provides examples for multiple platforms and includes a guide for newcomers and smart shopping tools. However, complete tool parameter lists are missing, and potential side effects on user accounts are not fully disclosed. Troubleshooting is comprehensive but depends on external API stability, and limitations such as cost or rate limits are not mentioned.
Setup experience 11/20
Installation steps are clear: requires Node.js and npm, with options for npx or local build. Provides Claude Desktop configuration examples with Windows and macOS paths. However, setting up environment variables and ensuring Node version compatibility may be extra steps. The need for real account credentials to run increases the barrier. No Docker or simplified deployment method is provided.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the networkChanges third-party account data

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.

Setup

Before you start

Runtime：Node.js

ROHLIK_USERNAME required Login email for your Rohlik (or regional) account.
ROHLIK_PASSWORD requiredsecret Your Rohlik account password, set in the client config.
Other optional settings (2)
ROHLIK_BASE_URL optional Regional base URL (e.g. https://www.rohlik.cz, https://www.knuspr.de); defaults to the Czech site if unset.
ROHLIK_DEBUG optional Set to true to enable detailed debug logs for troubleshooting authentication.
  1. Ensure Node.js and npm are installed.
  2. 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).
  3. 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"
      }
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

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

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add rohlik -e [email protected] -e ROHLIK_PASSWORD=your-password -e ROHLIK_BASE_URL=https://www.rohlik.cz -- npx -y @tomaspavlin/rohlik-mcp

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

After configuring, the rohlik server's tools such as search_products should appear in the client's tool list; asking 'What's in my cart?' and getting a result from get_cart_content confirms the connection.

Troubleshooting

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

Things to try

Once connected, you can ask your AI assistant things like:

  • Add ingredients for apple pie to the cart. Only gluten-free and budget-friendly.
  • Show me lunch suggestions for this week.
  • What's on sale this week?
  • What are the cheapest delivery slots for tomorrow?

Tools 18

search_products read-only
Search for grocery products by name with filtering options.
add_to_cart writes
Add multiple products to your shopping cart.
get_cart_content read-only
View current cart contents and totals.
remove_from_cart writes
Remove items from your shopping cart.
get_shopping_list read-only
Retrieve shopping lists by ID.
get_meal_suggestions read-only
Get personalized suggestions for breakfast, lunch, dinner, snacks, baking, drinks, or healthy eating based on your order history.
get_frequent_items read-only
Analyze order history to find most frequently purchased items (overall + per category).
get_shopping_scenarios read-only
Interactive guide showing what you can do with the MCP.
Show 10 more tools
get_discounted_items read-only
Browse currently discounted items, optionally filtered by food category, with sorting and pagination.
get_account_data read-only
Get comprehensive account information including delivery details, orders, announcements, cart, and premium status.
get_order_history read-only
View your past delivered orders with details.
get_order_detail read-only
Get detailed information about a specific order including all products.
get_upcoming_orders read-only
See your scheduled upcoming orders.
get_delivery_info read-only
Get current delivery information and fees.
get_delivery_slots read-only
View available delivery time slots for your address.
get_premium_info read-only
Check your Rohlik Premium subscription status and benefits.
get_announcements read-only
View current announcements and notifications.
get_reusable_bags_info read-only
Track your reusable bags and environmental impact.

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 Desktop

Listed from the project's documentation, not tested by this site.

Overview

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.

Similar servers

BioMCP 75 · B

One binary. One grammar. Evidence from the biomedical sources you already trust.

★ 653 · Tools 11 Compare with this →
Compare with other MCP servers

Source revision 9e824c5b1dba Data synced 2026-10-11 Read the FMRS scoring method