Rohlik

You can extend your AI assistant with Rohlik MCP Server to search products, manage carts, and access account information across multiple Rohlik regions. This enables practical, grocery-focused conversations and planning right from your preferred AI interface.

How to use

Use the MCP server through your client of choice (for example Claude Desktop) to perform regular shopping, smart shopping, and planning tasks. Core actions include searching for products, adding items to your cart, and viewing or retrieving order and account details. In smart shopping, you can get personalized meal suggestions, identify frequently purchased items, and explore shopping scenarios. For planning, you can check delivery slots, upcoming deliveries, and delivery fees. Remember to provide your Rohlik account credentials through the configured environment so the MCP can access your data securely.

How to install

Prerequisites you need before running the server: 1) Node.js (with npm) installed on your system. 2) Access to the Rohlik MCP server configuration details shown below.

Option A: Run via MCP client (recommended for testing and use within the client). Use the prebuilt MCP package with your client integration. Copy the configuration snippet into your client’s MCP settings to connect. The snippet below shows how to configure the client to start the Rohlik MCP server using npx.

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

Option B: Run locally from source (advanced)

If you prefer to run the MCP server locally, follow these steps to build and start the server using the provided dist index. This approach compiles the TypeScript sources and runs the local runtime.

Install dependencies and build the project, then start the server with the required environment variables.

npm install
npm run build

# Start the local MCP server directly from the built dist
ROHLIK_USERNAME=your-email@example.com ROHLIK_PASSWORD=your-password ROHLIK_BASE_URL=https://www.rohlik.cz node dist/index.js

Available 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 meal suggestions based on order history.

get_frequent_items

Analyze order history to find most frequently purchased items.

get_shopping_scenarios

Interactive guide showing what you can do with the MCP.

get_account_data

Get comprehensive account information including delivery details, orders, announcements, cart, and premium status.

get_order_history

View past delivered orders with details.

get_order_detail

Get detailed information about a specific order.

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 Rohlik Premium subscription status and benefits.

get_announcements

View current announcements and notifications.

get_reusable_bags_info

Track reusable bags and environmental impact.