Description

Gurkerl.at grocery shopping via MCP - search products, manage cart, orders, recipes, favorites.

README (SKILL.md)

Gurkerl.at MCP Skill

Name: Gurkerl
Author: florianbeer

Austrian grocery delivery service (part of Rohlik Group). Search products, manage your cart, view orders, browse recipes, and more.

Note: This skill uses Gurkerl's official MCP server. The same approach works for other Rohlik Group brands (Rohlik.cz, Knuspr.de, Kifli.hu) — just change the MCP URL in the script.

Setup

Set environment variables:

export GURKERL_EMAIL="[email protected]"
export GURKERL_PASS="your-password"

For persistent access, add to ~/.config/systemd/user/openclaw-gateway.service.d/gurkerl.conf:

[Service]
Environment="[email protected]"
Environment="GURKERL_PASS=your-password"

CLI Usage

# Search products (German keywords) — use batch_search_products with queries array
gurkerl batch_search_products '{"queries":[{"keyword":"Milch"}]}'
gurkerl batch_search_products '{"queries":[{"keyword":"Bio Eier","sort_type":"orderPriceAsc"}]}'

# Search multiple products at once (more efficient)
gurkerl batch_search_products '{"queries":[{"keyword":"Milch"},{"keyword":"Brot"},{"keyword":"Eier"}]}'

# Get cart
gurkerl get_cart

# Add to cart
gurkerl add_items_to_cart '{"items":[{"productId":1234567,"quantity":2}]}'

# View orders
gurkerl fetch_orders '{"limit":3}'
gurkerl fetch_orders '{"order_type":"upcoming"}'

# Search recipes
gurkerl search_recipes_by_vector_similarity '{"query":"vegetarisch schnell"}'

Available Tools

Products & Search

Tool	Description
`batch_search_products`	Search by keyword(s). Takes `{"queries":[{"keyword":"..."}]}`. Each query can include `sort_type`, filters. Use German keywords.
`get_products_details_batch`	Get details for multiple product IDs
`get_products_composition_batch`	Nutritional info, allergens, ingredients for multiple products

Cart

Tool	Description
`get_cart`	View current cart
`add_items_to_cart`	Add products: `{"items":[{"productId":123,"quantity":1}]}`
`update_cart_item`	Change quantity: `{"product_id":123,"quantity":3}`
`remove_cart_item`	Remove item: `{"product_id":123}`
`clear_cart`	Empty entire cart

Checkout

Tool	Description
`get_checkout`	View checkout state
`get_timeslots_checkout`	Available delivery timeslots
`change_timeslot_checkout`	Select a delivery timeslot
`change_checkout_packaging`	Change packaging options
`update_payment_method_checkout`	Change payment method
`submit_checkout`	Submit the order

Orders

Tool	Description
`fetch_orders`	Get order history. Params: `limit`, `order_type` (delivered/upcoming/both), `date_from`, `date_to`
`repeat_order`	Reorder: `{"order_id":12345678}`
`cancel_order`	Cancel upcoming order (two-step: first `customer_confirmed:false`, then `true`)
`get_alternative_timeslots`	Get available delivery times for existing order
`change_order_timeslot`	Change delivery slot for existing order
`remove_order_items`	Remove items from an upcoming order

Recipes

Tool	Description
`search_recipes_by_vector_similarity`	Semantic recipe search
`get_recipe_detail`	Full recipe with ingredients mapped to products
`generate_recipe_with_ingredients_search`	AI-generated recipes with product matches

User & Favorites

Tool	Description
`get_user_info`	Account profile
`get_user_credits`	Available credits/vouchers
`get_all_user_favorites`	All favorited products
`get_user_shopping_lists_preview`	List all shopping lists
`get_user_shopping_list_detail`	View list contents
`create_shopping_list`	Create new list
`add_products_to_shopping_list`	Add products to a list
`remove_products_from_shopping_list`	Remove products from a list
`delete_shopping_list`	Delete a shopping list

Customer Care

Tool	Description
`submit_claim`	File warranty claim for missing/damaged items
`submit_credit_compensation`	Request credit compensation
`get_customer_support_contact_info`	Phone, email, WhatsApp
`get_user_reusable_bags_info`	Check bag deposit status
`adjust_user_reusable_bags`	Correct bag count
`credit_customer_returnables`	Credit returnable deposits
`get_customer_care_workflow_prompt`	Internal workflow guidance

Analytics & Other

Tool	Description
`calculate_average_user_order`	Generate typical order from history
`analyze_spending`	Spending analysis and insights
`add_feedback`	Submit product/service feedback
`add_karma_rating`	Rate delivery/service
`get_faq_content`	FAQ for: general, xtra_general, xtra_price, baby_club, christmas
`get_url_content`	Fetch content from a URL
`email_support_on_user_behalf`	Send support email
`fetch_all_job_listings`	Career opportunities

Search Tips

Use German keywords for Austrian Gurkerl: "Milch", "Brot", "Eier", "Käse"
Batch multiple searches in one call for efficiency: {"queries":[{"keyword":"A"},{"keyword":"B"}]}
Each query object supports: keyword, sort_type, filters
Sort: orderPriceAsc, orderPriceDesc, recommended (default)
Filters available: news (new products), sales (on sale)
Include nutrition/allergens via get_products_composition_batch after getting product IDs

Example Workflows

Weekly Shopping

# Search multiple items at once
gurkerl batch_search_products '{"queries":[{"keyword":"Milch"},{"keyword":"Brot"},{"keyword":"Eier"}]}'

# Add to cart
gurkerl add_items_to_cart '{"items":[{"productId":MILK_ID,"quantity":2},{"productId":BREAD_ID,"quantity":1}]}'

# Review cart
gurkerl get_cart

Reorder Last Order

gurkerl fetch_orders '{"limit":1}'  # Get order ID
gurkerl repeat_order '{"order_id":ORDER_ID}'

Find Recipe & Add Ingredients

gurkerl search_recipes_by_vector_similarity '{"query":"schnelles Abendessen"}'
gurkerl get_recipe_detail '{"recipe_id":RECIPE_ID,"include_product_mapping":true}'
# Add matched products to cart

Usage Guidance

This skill looks coherent with its stated purpose (it uses your Gurkerl account to manage shopping), but there are two practical concerns you should consider before installing: (1) SKILL.md requires your Gurkerl email and password even though the registry metadata doesn't declare them — ask the publisher to clarify and preferably use an API token if available; (2) do not store your password in persistent files unless you understand the risk — avoid adding credentials to a systemd drop-in in cleartext; instead export them for a single session or create a dedicated low-privilege test account. Also confirm what 'email_support_on_user_behalf' and other actions do (which endpoints they call and whether they forward data externally). If you don't trust the unknown source, test with a throwaway account or request the skill's origin/source code before use.

Capability Analysis

Type: OpenClaw Skill Name: gurkerl Version: 1.1.1 The skill manages sensitive grocery account credentials (GURKERL_EMAIL, GURKERL_PASS) and provides tools for financial transactions like 'submit_checkout' and 'submit_credit_compensation'. It includes high-risk capabilities such as 'get_url_content' (potential SSRF/exfiltration) and 'email_support_on_user_behalf', which are unusually broad for a grocery shopping integration. While these tools are contextually framed as customer support features, the lack of implementation code and the requirement for plaintext credentials in environment variables create a significant attack surface without clear evidence of malicious intent in the documentation (SKILL.md).

Capability Assessment

ℹ Purpose & Capability

Name and description (Gurkerl MCP grocery actions) match the runtime instructions: the skill uses HTTP calls (curl/jq) and account credentials to search products, manage cart/orders, etc. Requiring an account email/password is plausible for this purpose. However the registry metadata claims no required env vars or config paths while SKILL.md explicitly requires GURKERL_EMAIL and GURKERL_PASS and suggests storing them in a systemd drop-in file — this inconsistency is notable.

ℹ Instruction Scope

SKILL.md contains detailed CLI-style instructions and lists many API-like tools (search, cart, checkout, support email). The instructions ask you to export your Gurkerl email/password and even show how to persist them in a systemd user drop-in file. Persisting cleartext account credentials and enabling actions such as 'email_support_on_user_behalf' increase the scope of what the skill can do with your account; the skill does not instruct reading unrelated system files, but it does direct writing credentials to a user-level system path which is beyond a minimal runtime scope.

✓ Install Mechanism

No install spec and no code files — instruction-only. That minimizes supply-chain risk (nothing is downloaded or written by an installer). It does require curl and jq to exist on PATH, which is reasonable for a CLI wrapper that performs REST calls and JSON parsing.

⚠ Credentials

The skill needs account credentials (GURKERL_EMAIL, GURKERL_PASS) which is proportionate to interacting with a user account, but the registry metadata does not declare these env vars while SKILL.md does — an inconsistency that reduces transparency. The instructions also recommend persisting the password in a systemd service drop-in file (~/.config/systemd/user/.../gurkerl.conf), which stores secrets in a file that may be readable by processes with access to your user config — this is a security/privacy risk and not strictly necessary for a simple CLI usage model.

ℹ Persistence & Privilege

The skill is not force-enabled (always:false) and is user-invocable. However SKILL.md explicitly suggests making credentials persistent by writing them into a systemd user drop-in file. That gives long-lived access to the account from the environment where the agent runs; it increases persistence risk if you enable it. The skill does not request elevated system privileges or modify other skills' configs.

Version History

v1.1.1

Fix: include bin/gurkerl CLI wrapper script (missing from 1.1.0 publish)

v1.1.0

Updated search API: search_products → batch_search_products with queries array. Added checkout, analytics, and new customer care tools. Full tool list synced with current MCP server.

v1.0.0

Initial release: 47 MCP tools for Austrian grocery shopping - products, cart, orders, recipes, favorites

Metadata

Slug gurkerl

Version 1.1.1

License MIT-0

All-time Installs 0

Active Installs 0

Total Versions 3

Frequently Asked Questions

What is Gurkerl?

Gurkerl.at grocery shopping via MCP - search products, manage cart, orders, recipes, favorites. It is an AI Agent Skill for Claude Code / OpenClaw, with 1952 downloads so far.

How do I install Gurkerl?

Run "/install gurkerl" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Gurkerl free?

Yes, Gurkerl is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Gurkerl support?

Gurkerl is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Gurkerl?

It is built and maintained by Florian Beer (@florianbeer); the current version is v1.1.1.

More Skills

Gurkerl