Skip to content
Back to search

mcp-picnic

Unofficial MCP Server for Picnic

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/ivo-toby/mcp-picnic with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/ivo-toby/mcp-picnic'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ivo-toby--mcp-picnic/badge.svg)](/listings/ivo-toby--mcp-picnic)

HTML

<a href="/listings/ivo-toby--mcp-picnic"><img src="/api/listings/ivo-toby--mcp-picnic/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. **Install the server**:

npm install -g mcp-picnic

2. **Configure Claude Desktop** to use the MCP server:

**macOS**: Edit `~/Library/Application Support/Claude/claude_desktop_config.json` **Windows**: Edit `%APPDATA%\Claude\claude_desktop_config.json`

Add this configuration:

{
  "mcpServers": {
    "picnic": {
      "command": "npx",
      "args": ["-y", "mcp-picnic"],
      "env": {
        "PICNIC_USERNAME": "your-picnic-email@example.com",
        "PICNIC_PASSWORD": "your-picnic-password",
        "PICNIC_COUNTRY_CODE": "NL"
      }
    }
  }
}

**Important**: - Replace `your-picnic-email@example.com` and `your-picnic-password` with your actual Picnic account credentials. - Set `PICNIC_COUNTRY_CODE` to `"DE"` for Germany, `"FR"` for France, or `"NL"` for the Netherlands (default).

3. **Restart Claude Desktop** completely

4. **Complete 2FA** (if enabled on your account) - ask your MCP client/assistant to call the `picnic_generate_2fa_code` tool, then provide the received code so it can call `picnic_verify_2fa_code`. See the [Authentication](#authentication) section for details.

5. **Start using it** - you should see a 🔨 hammer icon in the input area:

"I want to plan meals for this week and order groceries from Picnic"

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 1,337 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. [![MseeP.ai Security Assessment Badge](https://mseep.net/pr/ivo-toby-mcp-picnic-badge.png)](https://mseep.ai/app/ivo-toby-mcp-picnic)
  2. # MCP Picnic - AI-Powered Grocery Shopping Assistant
  3. [![smithery badge](https://smithery.ai/badge/@ivo-toby/mcp-picnic)](https://smithery.ai/server/@ivo-toby/mcp-picnic)
  4. An intelligent Model Context Protocol (MCP) server that enables AI assistants to interact with Picnic, the online supermarket delivery service. This server transforms your AI assistant into a smart grocery shopping companion that can help you plan meals, manage your shopping cart, track deliveries, and optimize your grocery shopping experience.
  5. ## What is MCP Picnic?
  6. MCP Picnic is a bridge between AI assistants (like Claude, ChatGPT, or other MCP-compatible tools) and Picnic's grocery delivery service. It provides:
  7. - **🛒 Smart Shopping**: Search products, manage your cart, and place orders through natural conversation
  8. - **🍽️ Meal Planning**: Get AI-powered meal plans with automatic shopping list generation
  9. - **💰 Budget Management**: Shop within your budget with cost-conscious recommendations
  10. - **🚚 Delivery Tracking**: Monitor your orders and optimize delivery schedules
  11. - **🥗 Dietary Support**: Find products that match your dietary restrictions and health goals
  12. - **📱 Complete Integration**: Access all Picnic features through your AI assistant
  13. ### Supported Countries
  14. - 🇳🇱 Netherlands
  15. - 🇩🇪 Germany
  16. - 🇫🇷 France
  17. ## Key Features
  18. ### 🤖 AI-Powered Shopping Tools
  19. - **Product Search**: Find any product in Picnic's catalog
  20. - **Weekly Promotions**: Fetch current Picnic deals from the app's promotions page
  21. - **Cart Management**: Add, remove, and modify items in your shopping cart
  22. - **Order Tracking**: Monitor delivery status and driver location
  23. - **Account Management**: Access your profile, payment methods, and order history
  24. ### 🎯 Intelligent Prompts
  25. - **Meal Planner**: Create weekly meal plans with automatic shopping lists
  26. - **Budget Shopping**: Stay within budget while maintaining quality
  27. - **Quick Dinners**: Find fast meal solutions for busy schedules
  28. - **Healthy Eating**: Get nutrition-focused product recommendations
  29. - **Special Occasions**: Plan for parties, holidays, and gatherings
  30. - **Pantry Restocking**: Maintain essential household supplies
  31. - **Recipe Recreation**: Find ingredients for specific recipes
  32. - **Dietary Substitutions**: Get alternatives for dietary restrictions
  33. ## How to Use
  34. ### Prerequisites
  35. - A Picnic account (available in Netherlands, Germany, or France)
  36. - An MCP-compatible AI assistant (Claude Desktop, Continue, etc.)
  37. - Node.js 18+ installed on your system
  38. ### Quick Start
  39. 1. **Install the server**:
  40. ```bash
  41. npm install -g mcp-picnic
  42. ```
  43. 2. **Configure Claude Desktop** to use the MCP server:
  44. **macOS**: Edit `~/Library/Application Support/Claude/claude_desktop_config.json`
  45. **Windows**: Edit `%APPDATA%\Claude\claude_desktop_config.json`
  46. Add this configuration:
  47. ```json
  48. {
  49. "mcpServers": {
  50. "picnic": {
  51. "command": "npx",
  52. "args": ["-y", "mcp-picnic"],
  53. "env": {
  54. "PICNIC_USERNAME": "your-picnic-email@example.com",
  55. "PICNIC_PASSWORD": "your-picnic-password",
  56. "PICNIC_COUNTRY_CODE": "NL"
  57. }
  58. }
  59. }
  60. }
  61. ```
  62. **Important**:
  63. - Replace `your-picnic-email@example.com` and `your-picnic-password` with your actual Picnic account credentials.
  64. - Set `PICNIC_COUNTRY_CODE` to `"DE"` for Germany, `"FR"` for France, or `"NL"` for the Netherlands (default).
  65. 3. **Restart Claude Desktop** completely
  66. 4. **Complete 2FA** (if enabled on your account) - ask your MCP client/assistant to call the `picnic_generate_2fa_code` tool, then provide the received code so it can call `picnic_verify_2fa_code`. See the [Authentication](#authentication) section for details.
  67. 5. **Start using it** - you should see a 🔨 hammer icon in the input area:
  68. ```
  69. "I want to plan meals for this week and order groceries from Picnic"
  70. ```
  71. ### Example Conversations
  72. **Meal Planning**:
  73. ```
  74. User: "Plan healthy meals for 2 people for 5 days, budget €75"
  75. AI: I'll help you create a healthy meal plan! First, let me log into your Picnic account...
  76. ```
  77. **Quick Shopping**:
  78. ```
  79. User: "I need ingredients for pasta carbonara tonight"
  80. AI: Let me search for carbonara ingredients on Picnic and add them to your cart...
  81. ```
  82. **Delivery Tracking**:
  83. ```
  84. User: "When is my grocery delivery arriving?"
  85. AI: Let me check your current deliveries and their status...
  86. ```
  87. ## Use Cases
  88. Here are some practical scenarios where MCP Picnic can transform your grocery shopping experience:
  89. ### 📖 **Recipe Browsing**
  90. **Scenario**: Picking a 20-minute recipe from the Picnic cookbook and inspecting its ingredients
  91. ```
  92. User: "Show me some quick weeknight recipes from Picnic and pick a chicken one"
  93. AI Actions:
  94. 1. Uses picnic_browse_recipes (no category) to list cookbook highlights and available category page IDs
  95. 2. Uses picnic_browse_recipes with category="20minuten" to fetch all recipes in the 20-minute category
  96. 3. Picks one with chicken from the title and uses picnic_get_recipe for the recipe id
  97. 4. Reads back the ingredients list, pantry items, cooking steps and recipe tips
  98. 5. Optionally uses picnic_save_recipe to save it for later
  99. ```
  100. ### 🍽️ **Smart Meal Planning**
  101. **Scenario**: Planning a week's worth of healthy meals for a family of 4
  102. ```
  103. User: "Plan 7 dinners for 4 people, focusing on Mediterranean diet, budget €100"
  104. AI Actions:
  105. 1. Uses picnic_search to find Mediterranean ingredients
  106. 2. Uses picnic_get_suggestions for recipe ideas
  107. 3. Uses picnic_add_to_cart to build shopping list
  108. 4. Uses picnic_get_cart to verify total cost
  109. 5. Uses picnic_get_delivery_slots to schedule delivery
  110. ```
  111. ### 🛒 **Intelligent Shopping Assistant**
  112. **Scenario**: Recreating a specific recipe with dietary substitutions
  113. ```
  114. User: "I want to make lasagna but need gluten-free and dairy-free alternatives"
  115. AI Actions:
  116. 1. Uses picnic_search to find gluten-free pasta
  117. 2. Uses picnic_get_suggestions for dairy-free cheese alternatives
  118. 3. Uses picnic_get_product_details to check ingredient details
  119. 4. Uses picnic_add_to_cart to add suitable products
  120. 5. Provides cooking tips and substitution ratios
  121. ```
  122. ### 📦 **Delivery Optimization**
  123. **Scenario**: Managing multiple deliveries and tracking orders
  124. ```
  125. User: "What's the status of all my orders and when will they arrive?"
  126. AI Actions:
  127. 1. Uses picnic_get_deliveries to list all current orders
  128. 2. Uses picnic_get_delivery_position for real-time tracking
  129. 3. Uses picnic_get_delivery_scenario for driver details
  130. 4. Suggests optimal delivery slots using picnic_get_delivery_slots
  131. 5. Sends invoice emails using picnic_send_delivery_invoice_email
  132. ```
  133. ### 💰 **Budget-Conscious Shopping**
  134. **Scenario**: Shopping within a strict budget while maintaining quality
  135. ```
  136. User: "I have €50 for groceries this week, help me maximize value"
  137. AI Actions:
  138. 1. Uses picnic_search to find budget-friendly staples
  139. 2. Uses picnic_get_product_details to inspect prices, package sizes, and promotions
  140. 3. Uses picnic_get_cart to track running total
  141. 4. Uses picnic_remove_from_cart if budget exceeded
  142. 5. Uses picnic_get_wallet_transactions to track spending patterns
  143. ```
  144. ### 🏠 **Household Management**
  145. **Scenario**: Managing shopping lists for different family members
  146. ```
  147. User: "Create separate shopping lists for weekly groceries and party supplies"
  148. AI Actions:
  149. 1. Uses picnic_search to find weekly grocery staples
  150. 2. Uses picnic_search to find party-specific items
  151. 3. Uses picnic_get_product_details to check pack sizes and ingredients
  152. 4. Uses picnic_add_to_cart when ready to order
  153. 5. Uses picnic_get_cart to review totals before checkout
  154. ```
  155. ### 🎉 **Event Planning**
  156. **Scenario**: Planning a dinner party for 12 guests
  157. ```
  158. User: "I'm hosting a dinner party for 12 people next Saturday, help me plan"
  159. AI Actions:
  160. 1. Uses picnic_search to find appetizer, main course, and dessert ingredients
  161. 2. Uses picnic_get_suggestions for wine pairings
  162. 3. Uses picnic_get_delivery_slots to schedule Friday delivery
  163. 4. Uses picnic_set_delivery_slot to book optimal time
  164. 5. Uses picnic_get_product_details to check product availability and sizes
  165. ```
  166. ### 🥗 **Health & Dietary Management**
  167. **Scenario**: Managing specific dietary requirements (diabetes, allergies)
  168. ```
  169. User: "Find low-carb options for a diabetic-friendly weekly menu"
  170. AI Actions:
  171. 1. Uses picnic_search with specific dietary keywords
  172. 2. Uses picnic_get_product_details to check nutritional information
  173. 3. Uses picnic_get_suggestions for healthy alternatives
  174. 4. Uses picnic_add_to_cart for approved items only
  175. 5. Tracks nutritional goals across multiple meals
  176. ```
  177. ### 📱 **Smart Reordering**
  178. **Scenario**: Automatically reordering household essentials
  179. ```
  180. User: "Reorder my usual weekly essentials and add some new seasonal items"
  181. AI Actions:
  182. 1. Uses picnic_get_user_details to check purchase history
  183. 2. Uses picnic_get_wallet_transactions to identify regular purchases
  184. 3. Uses picnic_search to find seasonal products
  185. 4. Uses picnic_add_to_cart for both regular and new items
  186. 5. Uses picnic_get_delivery_slots for convenient scheduling
  187. ```
  188. ### 🎯 **Price Comparison & Optimization**
  189. **Scenario**: Finding the best value products across categories
  190. ```
  191. User: "Compare prices for organic vs conventional produce this week"
  192. AI Actions:
  193. 1. Uses picnic_search for both organic and conventional items
  194. 2. Uses picnic_get_product_details to compare prices and sizes
  195. 3. Uses picnic_get_suggestions for similar brands and products
  196. 4. Uses picnic_get_cart to compare basket totals
  197. 5. Provides detailed cost analysis and recommendations
  198. ```
  199. ### 🚚 **Delivery Experience Management**
  200. **Scenario**: Optimizing delivery experience and providing feedback
  201. ```
  202. User: "Track my delivery and rate the service quality"
  203. AI Actions:
  204. 1. Uses picnic_get_delivery_position for real-time tracking
  205. 2. Uses picnic_get_delivery_scenario for driver communication
  206. 3. Uses picnic_rate_delivery after completion
  207. 4. Uses picnic_send_delivery_invoice_email for records
  208. 5. Uses picnic_get_order_status to confirm final order state
  209. ```
  210. ### 💳 **Financial Tracking**
  211. **Scenario**: Managing grocery budget and payment methods
  212. ```
  213. User: "Show me my grocery spending patterns and optimize my payment setup"
  214. AI Actions:
  215. 1. Uses picnic_get_wallet_transactions for spending analysis
  216. 2. Uses picnic_get_wallet_transaction_details for detailed breakdowns
  217. 3. Uses picnic_get_payment_profile to review payment methods
  218. 4. Provides insights on spending trends and budget optimization
  219. 5. Suggests cost-saving strategies based on purchase history
  220. ```
  221. These use cases demonstrate how MCP Picnic transforms simple grocery shopping into an intelligent, personalized experience that saves time, money, and effort while ensuring you never miss essential items or optimal deals.
  222. ## Setup Instructions
  223. ### Option 1: Install from NPM (Recommended)
  224. ```bash
  225. # Install globally
  226. npm install -g mcp-picnic
  227. # Or install locally in your project
  228. npm install mcp-picnic
  229. ```
  230. ### Option 2: Build from Source
  231. ```bash
  232. # Clone the repository
  233. git clone https://github.com/ivo-toby/mcp-picnic.git
  234. cd mcp-picnic
  235. # Install dependencies
  236. npm install
  237. # Build the project
  238. npm run build
  239. # Link globally (optional)
  240. npm link
  241. ```
  242. ### Option 3: Docker / Docker Compose
  243. ```bash
  244. # 1) Create .env with your Picnic credentials
  245. cat > .env <<EOF
  246. PICNIC_USERNAME=your-picnic-email@example.com
  247. PICNIC_PASSWORD=your-picnic-password
  248. PICNIC_COUNTRY_CODE=NL
  249. EOF
  250. # 2) Build and start
  251. docker compose up -d --build
  252. # 3) Check health
  253. docker compose ps
  254. curl http://localhost:3000/health
  255. ```
  256. Notes:
  257. - The container runs as a non-root user (UID `1638`).
  258. - Session persistence is configured via volume `picnic-data` mapped to `/app/data`.
  259. - `PICNIC_SESSION_FILE` defaults to `/app/data/picnic-session.json` in the container.
  260. - `PICNIC_DEVICE_FILE` defaults to `/app/data/picnic-device.json` in the container, so a generated device id is persisted on the same volume and reused across restarts.
  261. ### Configuration
  262. The server supports both stdio and HTTP transports:
  263. **Stdio Transport (Default)**:
  264. ```bash
  265. mcp-picnic
  266. ```
  267. **HTTP Transport**:
  268. ```bash
  269. mcp-picnic --enable-http --http-port 3000
  270. ```
  271. ### Environment Variables
  272. You can configure the server using environment variables:
  273. ```bash
  274. # Required: Picnic Account Credentials
  275. PICNIC_USERNAME=your-picnic-email@example.com
  276. PICNIC_PASSWORD=your-picnic-password
  277. # Country Configuration (optional, defaults to NL)
  278. # Set this to match your Picnic account's country
  279. # Supported values: NL (Netherlands), DE (Germany), FR (France)
  280. PICNIC_COUNTRY_CODE=NL
  281. # HTTP Transport settings (optional)
  282. ENABLE_HTTP_SERVER=true
  283. HTTP_PORT=3000
  284. # Default is localhost. Use 0.0.0.0 for Docker/external access.
  285. HTTP_HOST=0.0.0.0
  286. # Optional: protect HTTP endpoints with a shared token
  287. HTTP_AUTH_TOKEN=replace-with-a-long-random-token
  288. # Optional: HTTP header name to accept token auth (default: x-mcp-token)
  289. HTTP_AUTH_HEADER_NAME=x-mcp-token
  290. # Rate limiting for downstream HTTP consumers (defaults shown)
  291. HTTP_RATE_LIMIT_WINDOW_MS=900000
  292. HTTP_RATE_LIMIT_MAX_REQUESTS=100
  293. # Comma-separated paths excluded from the rate limiter
  294. HTTP_RATE_LIMIT_SKIP_PATHS=/health
  295. # Each MCP session gets its own HTTP_RATE_LIMIT_MAX_REQUESTS bucket (only for authorized
  296. # requests from the IP that created the session); other requests share their client IP's.
  297. # Admitted requests from one client IP are also capped in total (default: 10x MAX_REQUESTS).
  298. # HTTP_RATE_LIMIT_MAX_REQUESTS_PER_IP=1000
  299. # Behind a reverse proxy (Tailscale Serve, nginx, Caddy, ...) every request comes from the
  300. # proxy's IP, so all clients share one IP bucket and one per-IP total. Set Express's
  301. # "trust proxy" so the real client IP is read from X-Forwarded-For. Use "loopback" or a
  302. # subnet list (e.g. loopback, 10.0.0.0/8) matching your proxy's address. A hop count (1) or
  303. # "true" trusts X-Forwarded-For from anyone who reaches the port directly, letting them
  304. # spoof their IP; only use those when the port is reachable solely through the proxy.
  305. # Unset = trust none.
  306. # HTTP_TRUST_PROXY=loopback
  307. # Session persistence (optional, strongly recommended in containers)
  308. PICNIC_SESSION_FILE=~/.picnic-session.json
  309. # Picnic API settings (optional)
  310. PICNIC_API_VERSION=15
  311. # Device identity sent to the Picnic API (optional)
  312. # Defaults are provided by the picnic-api library; override these only if
  313. # Picnic starts rejecting requests (e.g. 2FA codes not arriving) before the
  314. # library ships updated defaults.
  315. PICNIC_DEVICE_ID=3C417201548B2E3B
  316. PICNIC_AGENT="30100;1.228.1-15480;"
  317. ```
  318. #### Country Configuration
  319. The `PICNIC_COUNTRY_CODE` setting determines which Picnic regional API to connect to. This **must match your Picnic account's country** for authentication to work correctly.
  320. - **Default**: `NL` (Netherlands)
  321. - **Supported values**:
  322. - `NL` - Netherlands (🇳🇱)
  323. - `DE` - Germany (🇩🇪)
  324. - `FR` - France (🇫🇷)
  325. **When to set this:**
  326. - If your Picnic account is registered in Germany, you **must** set `PICNIC_COUNTRY_CODE=DE`
  327. - If your Picnic account is registered in France, you **must** set `PICNIC_COUNTRY_CODE=FR`
  328. - If your Picnic account is in the Netherlands, you can omit this setting (defaults to `NL`)
  329. **Example for German accounts:**
  330. ```bash
  331. PICNIC_USERNAME=your-email@example.com
  332. PICNIC_PASSWORD=your-password
  333. PICNIC_COUNTRY_CODE=DE
  334. ```
  335. #### HTTP Token Authentication
  336. When `HTTP_AUTH_TOKEN` is set, all HTTP endpoints except `/health` require authentication. You can authenticate with either:
  337. - Custom HTTP header token: `<HTTP_AUTH_HEADER_NAME>: YOUR_TOKEN` (defaults to `x-mcp-token`)
  338. - Authorization header bearer token: `Authorization: Bearer YOUR_TOKEN`
  339. Example requests:
  340. ```bash
  341. curl -H "x-mcp-token: YOUR_TOKEN" "http://localhost:3000/mcp"
  342. curl -H "Authorization: Bearer YOUR_TOKEN" "http://localhost:3000/sessions"
  343. ```
  344. If the token is missing or invalid, the server responds with `401 Unauthorized`.
  345. ### MCP Client Configuration
  346. #### Claude Desktop
  347. **Configuration File Locations:**
  348. - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
  349. - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
  350. **Configuration:**
  351. ```json
  352. {
  353. "mcpServers": {
  354. "picnic": {
  355. "command": "npx",
  356. "args": ["-y", "mcp-picnic"],
  357. "env": {
  358. "PICNIC_USERNAME": "your-picnic-email@example.com",
  359. "PICNIC_PASSWORD": "your-picnic-password",
  360. "PICNIC_COUNTRY_CODE": "NL"
  361. }
  362. }
  363. }
  364. }
  365. ```
  366. **Important**:
  367. - Replace the placeholder credentials with your actual Picnic account details
  368. - Set `PICNIC_COUNTRY_CODE` to `"DE"` for Germany, `"FR"` for France, or `"NL"` for the Netherlands (default)
  369. **Setup Steps:**
  370. 1. Open Claude Desktop
  371. 2. Go to Claude menu → Settings (not the in-app settings)
  372. 3. Click "Developer" in the left sidebar
  373. 4. Click "Edit Config" to open the configuration file
  374. 5. Add the configuration above
  375. 6. Save the file and restart Claude Desktop
  376. 7. Look for the 🔨 hammer icon in the input area
  377. #### Continue (VS Code)
  378. Add to your Continue configuration:
  379. ```json
  380. {
  381. "mcpServers": [
  382. {
  383. "name": "picnic",
  384. "command": "npx",
  385. "args": ["-y", "mcp-picnic"],
  386. "env": {
  387. "PICNIC_USERNAME": "your-picnic-email@example.com",
  388. "PICNIC_PASSWORD": "your-picnic-password",
  389. "PICNIC_COUNTRY_CODE": "NL"
  390. }
  391. }
  392. ]
  393. }
  394. ```
  395. **Note**: Set `PICNIC_COUNTRY_CODE` to `"DE"` for Germany or `"FR"` for France. Netherlands accounts can omit this field (defaults to `"NL"`).
  396. ## Authentication
  397. The server uses the credentials configured in your environment variables:
  398. 1. **Required**: Set `PICNIC_USERNAME` and `PICNIC_PASSWORD` in your MCP configuration
  399. 2. **Session Persistence**: After successful authentication, your session is saved to `~/.picnic-session.json` and reused across restarts. You can customize this path with the `PICNIC_SESSION_FILE` environment variable.
  400. ### Two-Factor Authentication (2FA)
  401. If your Picnic account has 2FA enabled, complete the verification flow using MCP tools:
  402. 1. Call `picnic_generate_2fa_code` to send a verification code (usually SMS).
  403. 2. Call `picnic_verify_2fa_code` with the received OTP code.
  404. > Important: In Docker, the server itself cannot "chat" or type the code for you. Your MCP client (Claude Desktop, Continue, etc.) must trigger these tools.
  405. To avoid repeated 2FA challenges and container restart loops, persist `PICNIC_SESSION_FILE` to a Docker volume.
  406. When 2FA is pending, the server stays up so your client can complete `picnic_generate_2fa_code` and `picnic_verify_2fa_code`.
  407. **Security Note**: Credentials are used only for Picnic API authentication. The session token is stored locally at `PICNIC_SESSION_FILE`; the password is never stored on disk.
  408. ## Available Tools
  409. The server provides comprehensive access to Picnic's functionality through 30+ specialized tools:
  410. ### Authentication & Account Management
  411. - **`picnic_generate_2fa_code`** - Generate 2FA verification code (SMS/other channels)
  412. - **`picnic_verify_2fa_code`** - Verify 2FA code for authentication
  413. - **`picnic_get_user_details`** - Get current user profile information
  414. - **`picnic_get_user_info`** - Get user information including feature toggles
  415. **Note**: Authentication is handled automatically using credentials from environment variables (`PICNIC_USERNAME` and `PICNIC_PASSWORD`). No manual login is required.
  416. ### Product Discovery & Search
  417. - **`picnic_search`** - Search for products by name or keywords
  418. - **`picnic_get_promotions`** - Get current weekly promotions/deals with prices and labels
  419. - **`picnic_get_suggestions`** - Get product suggestions based on query
  420. - **`picnic_get_product_details`** - Get detailed information about a specific product
  421. - **`picnic_get_image`** - Get product images in various sizes (tiny to extra-large)
  422. **Note**: `picnic_get_categories` is not available. The underlying `picnic-api` package removed `getCategories()` in v4; category browsing would need a new Fusion page implementation.
  423. ### Recipe & Meal Planning
  424. - **`picnic_browse_recipes`** - Browse Picnic recipes, including category page IDs and category-specific listings
  425. - **`picnic_get_recipe`** - Get details for a specific recipe
  426. - **`picnic_get_recipe_ingredients`** - Extract recipe ingredients
  427. - **`picnic_get_multiple_recipe_ingredients`** - Extract ingredients from multiple recipes
  428. - **`picnic_build_shopping_list`** - Build a consolidated shopping list
  429. - **`picnic_find_meal_combinations`** - Find meal combinations within constraints
  430. - **`picnic_add_recipe_to_cart`** - Add recipe ingredients to the cart
  431. - **`picnic_remove_recipe_from_cart`** - Remove recipe ingredients from the cart
  432. - **`picnic_get_saved_recipes`** - Get saved recipes
  433. - **`picnic_get_own_recipes`** - Get user-created recipes
  434. - **`picnic_save_recipe`** - Save a recipe
  435. - **`picnic_unsave_recipe`** - Remove a saved recipe
  436. ### Shopping Cart Management
  437. - **`picnic_get_cart`** - View current shopping cart contents and totals
  438. - **`picnic_add_to_cart`** - Add products to cart with specified quantities
  439. - **`picnic_remove_from_cart`** - Remove products from cart with specified quantities
  440. - **`picnic_clear_cart`** - Clear all items from the shopping cart
  441. ### Delivery & Order Management
  442. - **`picnic_get_delivery_slots`** - View available delivery time slots
  443. - **`picnic_set_delivery_slot`** - Select and book a delivery time slot
  444. - **`picnic_get_deliveries`** - Get list of past and current deliveries with filters
  445. - **`picnic_get_delivery`** - Get detailed information about a specific delivery
  446. - **`picnic_get_delivery_position`** - Track real-time driver location and ETA
  447. - **`picnic_get_delivery_scenario`** - Get driver and route information
  448. - **`picnic_cancel_delivery`** - Cancel a scheduled delivery
  449. - **`picnic_rate_delivery`** - Rate completed deliveries (0-10 scale)
  450. - **`picnic_send_delivery_invoice_email`** - Send/resend delivery invoice emails
  451. - **`picnic_get_order_status`** - Check status of specific orders
  452. ### Payment & Financial
  453. - **`picnic_get_payment_profile`** - View payment methods and billing information
  454. - **`picnic_get_wallet_transactions`** - Get wallet transaction history (paginated)
  455. - **`picnic_get_wallet_transaction_details`** - Get detailed transaction information
  456. ## Development
  457. ### Running in Development Mode
  458. ```bash
  459. # Clone and setup
  460. git clone https://github.com/ivo-toby/mcp-picnic.git
  461. cd mcp-picnic
  462. npm install
  463. # Development with hot reload
  464. npm run dev
  465. # Run tests
  466. npm test
  467. # Type checking
  468. npm run typecheck
  469. # Linting
  470. npm run lint
  471. ```
  472. ### Project Structure
  473. ```
  474. src/
  475. ├── index.ts # Main server entry point
  476. ├── config.ts # Configuration management
  477. ├── tools/ # Picnic API tool implementations
  478. ├── prompts/ # AI prompt templates
  479. ├── resources/ # Resource definitions
  480. ├── handlers/ # Request handlers
  481. ├── transports/ # Transport layer (stdio/HTTP)
  482. └── utils/ # Utility functions
  483. ```
  484. ## Contributing
  485. We welcome contributions! Please see our [contributing guidelines](CONTRIBUTING.md) for details.
  486. ## License
  487. MIT License - see [LICENSE](LICENSE) file for details.
  488. ## Support
  489. - 📖 [Documentation](https://github.com/ivo-toby/mcp-picnic/wiki)
  490. - 🐛 [Report Issues](https://github.com/ivo-toby/mcp-picnic/issues)
  491. - 💬 [Discussions](https://github.com/ivo-toby/mcp-picnic/discussions)
  492. ---
  493. # MCP Picnic - AI-Gestuurde Boodschappen Assistent (Nederlands)
  494. Een intelligente Model Context Protocol (MCP) server die AI-assistenten in staat stelt om te communiceren met Picnic, de online supermarkt bezorgservice. Deze server transformeert je AI-assistent in een slimme boodschappen-companion die je kan helpen met maaltijdplanning, het beheren van je winkelwagen, het volgen van leveringen, en het optimaliseren van je boodschappen-ervaring.
  495. ## Wat is MCP Picnic?
  496. MCP Picnic is een brug tussen AI-assistenten (zoals Claude, ChatGPT, of andere MCP-compatibele tools) en Picnic's bezorgservice voor boodschappen. Het biedt:
  497. - **🛒 Slim Winkelen**: Zoek producten, beheer je winkelwagen, en plaats bestellingen via natuurlijke conversatie
  498. - **🍽️ Maaltijdplanning**: Krijg AI-gestuurde maaltijdplannen met automatische boodschappenlijst generatie
  499. - **💰 Budget Beheer**: Shop binnen je budget met kostenefficiënte aanbevelingen
  500. - **🚚 Bezorging Volgen**: Monitor je bestellingen en optimaliseer bezorgschema's
  501. - **🥗 Dieet Ondersteuning**: Vind producten die passen bij je dieetbeperkingen en gezondheidsdoelen
  502. - **📱 Volledige Integratie**: Toegang tot alle Picnic functies via je AI-assistent
  503. ### Ondersteunde Landen
  504. - 🇳🇱 Nederland
  505. - 🇩🇪 Duitsland
  506. ## Belangrijkste Functies
  507. ### 🤖 AI-Gestuurde Winkel Tools
  508. - **Product Zoeken**: Vind elk product in Picnic's catalogus
  509. - **Winkelwagen Beheer**: Voeg toe, verwijder, en wijzig items in je winkelwagen
  510. - **Bestelling Volgen**: Monitor bezorgstatus en chauffeur locatie
  511. - **Account Beheer**: Toegang tot je profiel, betaalmethoden, en bestelgeschiedenis
  512. ### 🎯 Intelligente Prompts
  513. - **Maaltijdplanner**: Creëer wekelijkse maaltijdplannen met automatische boodschappenlijsten
  514. - **Budget Winkelen**: Blijf binnen budget terwijl je kwaliteit behoudt
  515. - **Snelle Diners**: Vind snelle maaltijdoplossingen voor drukke schema's
  516. - **Gezond Eten**: Krijg voeding-gerichte productaanbevelingen
  517. - **Speciale Gelegenheden**: Plan voor feesten, vakanties, en bijeenkomsten
  518. - **Voorraadkast Aanvullen**: Onderhoud essentiële huishoudelijke benodigdheden
  519. - **Recept Recreatie**: Vind ingrediënten voor specifieke recepten
  520. - **Dieet Vervangingen**: Krijg alternatieven voor dieetbeperkingen
  521. ## Hoe te Gebruiken
  522. ### Vereisten
  523. - Een Picnic account (beschikbaar in Nederland of Duitsland)
  524. - Een MCP-compatibele AI-assistent (Claude Desktop, Continue, etc.)
  525. - Node.js 18+ geïnstalleerd op je systeem
  526. ### Snelle Start
  527. 1. **Installeer de server**:
  528. ```bash
  529. npm install -g mcp-picnic
  530. ```
  531. 2. **Configureer Claude Desktop** om de MCP server te gebruiken:
  532. **macOS**: Bewerk `~/Library/Application Support/Claude/claude_desktop_config.json`
  533. **Windows**: Bewerk `%APPDATA%\Claude\claude_desktop_config.json`
  534. Voeg deze configuratie toe:
  535. ```json
  536. {
  537. "mcpServers": {
  538. "picnic": {
  539. "command": "npx",
  540. "args": ["-y", "mcp-picnic"],
  541. "env": {
  542. "PICNIC_USERNAME": "jouw-picnic-email@example.com",
  543. "PICNIC_PASSWORD": "jouw-picnic-wachtwoord",
  544. "PICNIC_COUNTRY_CODE": "NL"
  545. }
  546. }
  547. }
  548. }
  549. ```
  550. **Belangrijk**:
  551. - Vervang `jouw-picnic-email@example.com` en `jouw-picnic-wachtwoord` met je echte Picnic account gegevens.
  552. - Stel `PICNIC_COUNTRY_CODE` in op `"DE"` als je Picnic account in Duitsland geregistreerd is. Voor Nederlandse accounts kun je dit veld weglaten of instellen op `"NL"`.
  553. 3. **Herstart Claude Desktop** volledig
  554. 4. **Begin met gebruiken** - je zou een 🔨 hamer icoon moeten zien in het invoerveld:
  555. ```
  556. "Ik wil maaltijden plannen voor deze week en boodschappen bestellen bij Picnic"
  557. ```
  558. ## Setup Instructies
  559. ### Optie 1: Installeer van NPM (Aanbevolen)
  560. ```bash
  561. # Installeer globaal
  562. npm install -g mcp-picnic
  563. # Of installeer lokaal in je project
  564. npm install mcp-picnic
  565. ```
  566. ### Optie 2: Bouw van Bron
  567. ```bash
  568. # Kloon de repository
  569. git clone https://github.com/ivo-toby/mcp-picnic.git
  570. cd mcp-picnic
  571. # Installeer dependencies
  572. npm install
  573. # Bouw het project
  574. npm run build
  575. # Link globaal (optioneel)
  576. npm link
  577. ```
  578. ## Authenticatie
  579. De server gebruikt de inloggegevens die geconfigureerd zijn in je omgevingsvariabelen:
  580. 1. **Vereist**: Stel `PICNIC_USERNAME` en `PICNIC_PASSWORD` in je MCP configuratie in
  581. 2. **Sessie opslag**: Na succesvolle authenticatie wordt je sessie opgeslagen in `~/.picnic-session.json` en hergebruikt bij herstarts. Je kunt dit pad aanpassen met de `PICNIC_SESSION_FILE` omgevingsvariabele.
  582. ### Tweefactorauthenticatie (2FA)
  583. Als je Picnic-account 2FA heeft ingeschakeld, moet je de verificatie voltooien voordat je de winkeltools kunt gebruiken. Vraag bij je eerste gesprek na het starten van de server aan de AI-assistent om:
  584. 1. **Een 2FA-code te genereren**: De assistent roept `picnic_generate_2fa_code` aan om een verificatiecode via SMS naar je telefoon te sturen
  585. 2. **De code in te voeren**: Vertel de assistent de code die je hebt ontvangen, en deze roept `picnic_verify_2fa_code` aan om de authenticatie te voltooien
  586. Zodra 2FA is geverifieerd, wordt je sessie opgeslagen en hoef je deze stap niet te herhalen totdat de sessie verloopt.
  587. **Voorbeeld**:
  588. ```
  589. Gebruiker: "Ik moet mijn Picnic account verifiëren"
  590. AI: Ik genereer een 2FA-code voor je... Er is een code naar je telefoon gestuurd via SMS.
  591. Gebruiker: "De code is 123456"
  592. AI: Je 2FA-code is geverifieerd. Je bent nu volledig geauthenticeerd en kunt beginnen met winkelen!
  593. ```
  594. **Beveiligingsnotitie**: Je inloggegevens worden alleen gebruikt om te authenticeren met Picnic's API. Het sessietoken wordt lokaal opgeslagen in `~/.picnic-session.json`. Je wachtwoord wordt nooit op schijf opgeslagen.
  595. ## Gebruiksscenario's
  596. Hier zijn enkele praktische scenario's waarin MCP Picnic je boodschappen-ervaring kan transformeren:
  597. ### 📖 **Recepten Bladeren**
  598. **Scenario**: Een recept van 20 minuten kiezen uit het Picnic-kookboek en de ingrediënten bekijken
  599. ```
  600. Gebruiker: "Laat me snelle doordeweekse recepten zien van Picnic en kies een kiprecept"
  601. AI Acties:
  602. 1. Gebruikt picnic_browse_recipes (zonder categorie) om de kookboek-highlights en beschikbare categoriepagina's op te halen
  603. 2. Gebruikt picnic_browse_recipes met category="20minuten" om alle recepten in die categorie te tonen
  604. 3. Kiest er een met kip in de titel en gebruikt picnic_get_recipe met het recipe id
  605. 4. Geeft de ingrediëntenlijst, voorraadkast-spullen, bereidingsstappen en recepttips terug
  606. 5. Slaat het recept eventueel op met picnic_save_recipe
  607. ```
  608. ### 🍽️ **Slimme Maaltijdplanning**
  609. **Scenario**: Een week vol gezonde maaltijden plannen voor een gezin van 4
  610. ```
  611. Gebruiker: "Plan 7 avondmaaltijden voor 4 personen, focus op mediterraan dieet, budget €100"
  612. AI Acties:
  613. 1. Gebruikt picnic_search om mediterrane ingrediënten te vinden
  614. 2. Gebruikt picnic_get_suggestions voor recept ideeën
  615. 3. Gebruikt picnic_add_to_cart om boodschappenlijst op te bouwen
  616. 4. Gebruikt picnic_get_cart om totale kosten te verifiëren
  617. 5. Gebruikt picnic_get_delivery_slots om bezorging in te plannen
  618. ```
  619. ### 🛒 **Intelligente Boodschappen Assistent**
  620. **Scenario**: Een specifiek recept recreëren met dieet vervangingen
  621. ```
  622. Gebruiker: "Ik wil lasagne maken maar heb glutenvrije en zuivelvrije alternatieven nodig"
  623. AI Acties:
  624. 1. Gebruikt picnic_search om glutenvrije pasta te vinden
  625. 2. Gebruikt picnic_get_suggestions voor zuivelvrije kaas alternatieven
  626. 3. Gebruikt picnic_get_product_details om ingrediënt details te controleren
  627. 4. Gebruikt picnic_add_to_cart om geschikte producten toe te voegen
  628. 5. Geeft kooktips en vervangingsverhoudingen
  629. ```
  630. ### 📦 **Bezorging Optimalisatie**
  631. **Scenario**: Meerdere bezorgingen beheren en bestellingen volgen
  632. ```
  633. Gebruiker: "Wat is de status van al mijn bestellingen en wanneer komen ze aan?"
  634. AI Acties:
  635. 1. Gebruikt picnic_get_deliveries om alle huidige bestellingen te tonen
  636. 2. Gebruikt picnic_get_delivery_position voor real-time tracking
  637. 3. Gebruikt picnic_get_delivery_scenario voor chauffeur details
  638. 4. Stelt optimale bezorgtijden voor met picnic_get_delivery_slots
  639. 5. Verstuurt factuur emails met picnic_send_delivery_invoice_email
  640. ```
  641. ### 💰 **Budget-Bewust Winkelen**
  642. **Scenario**: Winkelen binnen een strikt budget terwijl kwaliteit behouden blijft
  643. ```
  644. Gebruiker: "Ik heb €50 voor boodschappen deze week, help me de waarde te maximaliseren"
  645. AI Acties:
  646. 1. Gebruikt picnic_search om budget-vriendelijke basisproducten te vinden
  647. 2. Gebruikt picnic_get_product_details om prijzen, verpakkingsmaten en promoties te controleren
  648. 3. Gebruikt picnic_get_cart om lopend totaal bij te houden
  649. 4. Gebruikt picnic_remove_from_cart als budget overschreden wordt
  650. 5. Gebruikt picnic_get_wallet_transactions om uitgavenpatronen te volgen
  651. ```
  652. ### 🏠 **Huishouden Beheer**
  653. **Scenario**: Boodschappenlijsten beheren voor verschillende gezinsleden
  654. ```
  655. Gebruiker: "Maak aparte boodschappenlijsten voor wekelijkse boodschappen en feestbenodigdheden"
  656. AI Acties:
  657. 1. Gebruikt picnic_search om wekelijkse basisboodschappen te vinden
  658. 2. Gebruikt picnic_search om feest-specifieke items te vinden
  659. 3. Gebruikt picnic_get_product_details om verpakkingsmaten en ingrediënten te controleren
  660. 4. Gebruikt picnic_add_to_cart wanneer klaar om te bestellen
  661. 5. Gebruikt picnic_get_cart om totalen voor het afrekenen te controleren
  662. ```
  663. ### 🎉 **Evenement Planning**
  664. **Scenario**: Een dinerfeest plannen voor 12 gasten
  665. ```
  666. Gebruiker: "Ik organiseer een dinerfeest voor 12 personen aanstaande zaterdag, help me plannen"
  667. AI Acties:
  668. 1. Gebruikt picnic_search om voorgerechten, hoofdgerechten en dessert ingrediënten te vinden
  669. 2. Gebruikt picnic_get_suggestions voor wijn combinaties
  670. 3. Gebruikt picnic_get_delivery_slots om vrijdag bezorging in te plannen
  671. 4. Gebruikt picnic_set_delivery_slot om optimale tijd te boeken
  672. 5. Gebruikt picnic_get_product_details om product beschikbaarheid en maten te controleren
  673. ```
  674. ### 🥗 **Gezondheid & Dieet Beheer**
  675. **Scenario**: Specifieke dieetvereisten beheren (diabetes, allergieën)
  676. ```
  677. Gebruiker: "Vind koolhydraatarme opties voor een diabetesvriendelijk weekmenu"
  678. AI Acties:
  679. 1. Gebruikt picnic_search met specifieke dieet zoekwoorden
  680. 2. Gebruikt picnic_get_product_details om voedingswaarde informatie te controleren
  681. 3. Gebruikt picnic_get_suggestions voor gezonde alternatieven
  682. 4. Gebruikt picnic_add_to_cart alleen voor goedgekeurde items
  683. 5. Volgt voedingsdoelen over meerdere maaltijden
  684. ```
  685. ### 📱 **Slimme Herbestelling**
  686. **Scenario**: Automatisch herbestellen van huishoudelijke essentials
  687. ```
  688. Gebruiker: "Bestel mijn gebruikelijke wekelijkse essentials opnieuw en voeg wat nieuwe seizoensproducten toe"
  689. AI Acties:
  690. 1. Gebruikt picnic_get_user_details om aankoopgeschiedenis te controleren
  691. 2. Gebruikt picnic_get_wallet_transactions om reguliere aankopen te identificeren
  692. 3. Gebruikt picnic_search om seizoensproducten te vinden
  693. 4. Gebruikt picnic_add_to_cart voor zowel reguliere als nieuwe items
  694. 5. Gebruikt picnic_get_delivery_slots voor handige planning
  695. ```
  696. ### 🎯 **Prijsvergelijking & Optimalisatie**
  697. **Scenario**: De beste waarde producten vinden in verschillende categorieën
  698. ```
  699. Gebruiker: "Vergelijk prijzen voor biologische vs conventionele groenten deze week"
  700. AI Acties:
  701. 1. Gebruikt picnic_search voor zowel biologische als conventionele items
  702. 2. Gebruikt picnic_get_product_details om prijzen en maten te vergelijken
  703. 3. Gebruikt picnic_get_suggestions voor vergelijkbare merken en producten
  704. 4. Gebruikt picnic_get_cart om mandtotalen te vergelijken
  705. 5. Geeft gedetailleerde kostenanalyse en aanbevelingen
  706. ```
  707. ### 🚚 **Bezorgervaring Beheer**
  708. **Scenario**: Bezorgervaring optimaliseren en feedback geven
  709. ```
  710. Gebruiker: "Volg mijn bezorging en beoordeel de servicekwaliteit"
  711. AI Acties:
  712. 1. Gebruikt picnic_get_delivery_position voor real-time tracking
  713. 2. Gebruikt picnic_get_delivery_scenario voor chauffeur communicatie
  714. 3. Gebruikt picnic_rate_delivery na voltooiing
  715. 4. Gebruikt picnic_send_delivery_invoice_email voor administratie
  716. 5. Gebruikt picnic_get_order_status om de uiteindelijke bestelstatus te bevestigen
  717. ```
  718. ### 💳 **Financiële Tracking**
  719. **Scenario**: Boodschappenbudget beheren en betalingsmethoden optimaliseren
  720. ```
  721. Gebruiker: "Toon me mijn boodschappen uitgavenpatronen en optimaliseer mijn betalingsinstellingen"
  722. AI Acties:
  723. 1. Gebruikt picnic_get_wallet_transactions voor uitgavenanalyse
  724. 2. Gebruikt picnic_get_wallet_transaction_details voor gedetailleerde uitsplitsingen
  725. 3. Gebruikt picnic_get_payment_profile om betalingsmethoden te bekijken
  726. 4. Geeft inzichten over uitgaventrends en budget optimalisatie
  727. 5. Stelt kostenbesparende strategieën voor gebaseerd op aankoopgeschiedenis
  728. ```
  729. Deze gebruiksscenario's tonen hoe MCP Picnic eenvoudige boodschappen doen transformeert in een intelligente, gepersonaliseerde ervaring die tijd, geld en moeite bespaart terwijl je nooit essentiële items of optimale aanbiedingen mist.
  730. ---
  731. # MCP Picnic - KI-Gesteuerte Lebensmittel-Einkaufsassistent (Deutsch)
  732. Ein intelligenter Model Context Protocol (MCP) Server, der KI-Assistenten ermöglicht, mit Picnic, dem Online-Supermarkt-Lieferservice, zu interagieren. Dieser Server verwandelt Ihren KI-Assistenten in einen intelligenten Einkaufsbegleiter, der Ihnen bei der Mahlzeitenplanung, der Verwaltung Ihres Einkaufswagens, der Verfolgung von Lieferungen und der Optimierung Ihres Einkaufserlebnisses helfen kann.
  733. ## Was ist MCP Picnic?
  734. MCP Picnic ist eine Brücke zwischen KI-Assistenten (wie Claude, ChatGPT oder anderen MCP-kompatiblen Tools) und Picnics Lebensmittel-Lieferservice. Es bietet:
  735. - **🛒 Intelligentes Einkaufen**: Suchen Sie Produkte, verwalten Sie Ihren Warenkorb und geben Sie Bestellungen über natürliche Unterhaltung auf
  736. - **🍽️ Mahlzeitenplanung**: Erhalten Sie KI-gesteuerte Mahlzeitenpläne mit automatischer Einkaufslistenerstellung
  737. - **💰 Budget-Management**: Kaufen Sie innerhalb Ihres Budgets mit kostenbewussten Empfehlungen ein
  738. - **🚚 Lieferverfolgung**: Überwachen Sie Ihre Bestellungen und optimieren Sie Lieferpläne
  739. - **🥗 Diät-Unterstützung**: Finden Sie Produkte, die zu Ihren Ernährungseinschränkungen und Gesundheitszielen passen
  740. - **📱 Vollständige Integration**: Zugriff auf alle Picnic-Funktionen über Ihren KI-Assistenten
  741. ### Unterstützte Länder
  742. - 🇳🇱 Niederlande
  743. - 🇩🇪 Deutschland
  744. ## Hauptfunktionen
  745. ### 🤖 KI-Gesteuerte Einkaufs-Tools
  746. - **Produktsuche**: Finden Sie jedes Produkt in Picnics Katalog
  747. - **Warenkorbverwaltung**: Hinzufügen, entfernen und ändern Sie Artikel in Ihrem Warenkorb
  748. - **Bestellverfolgung**: Überwachen Sie Lieferstatus und Fahrerstandort
  749. - **Kontoverwaltung**: Zugriff auf Ihr Profil, Zahlungsmethoden und Bestellhistorie
  750. ### 🎯 Intelligente Prompts
  751. - **Mahlzeitenplaner**: Erstellen Sie wöchentliche Mahlzeitenpläne mit automatischen Einkaufslisten
  752. - **Budget-Einkauf**: Bleiben Sie im Budget und behalten dabei die Qualität bei
  753. - **Schnelle Abendessen**: Finden Sie schnelle Mahlzeitenlösungen für geschäftige Zeitpläne
  754. - **Gesunde Ernährung**: Erhalten Sie ernährungsorientierte Produktempfehlungen
  755. - **Besondere Anlässe**: Planen Sie für Partys, Feiertage und Versammlungen
  756. - **Vorratskammer-Auffüllung**: Pflegen Sie wesentliche Haushaltsvorräte
  757. - **Rezept-Nachstellung**: Finden Sie Zutaten für spezifische Rezepte
  758. - **Diät-Ersatz**: Erhalten Sie Alternativen für Ernährungseinschränkungen
  759. ## Wie zu Verwenden
  760. ### Voraussetzungen
  761. - Ein Picnic-Konto (verfügbar in den Niederlanden oder Deutschland)
  762. - Ein MCP-kompatibler KI-Assistent (Claude Desktop, Continue, etc.)
  763. - Node.js 18+ auf Ihrem System installiert
  764. ### Schnellstart
  765. 1. **Installieren Sie den Server**:
  766. ```bash
  767. npm install -g mcp-picnic
  768. ```
  769. 2. **Konfigurieren Sie Claude Desktop**, um den MCP-Server zu verwenden:
  770. **macOS**: Bearbeiten Sie `~/Library/Application Support/Claude/claude_desktop_config.json`
  771. **Windows**: Bearbeiten Sie `%APPDATA%\Claude\claude_desktop_config.json`
  772. Fügen Sie diese Konfiguration hinzu:
  773. ```json
  774. {
  775. "mcpServers": {
  776. "picnic": {
  777. "command": "npx",
  778. "args": ["-y", "mcp-picnic"],
  779. "env": {
  780. "PICNIC_USERNAME": "ihre-picnic-email@example.com",
  781. "PICNIC_PASSWORD": "ihr-picnic-passwort",
  782. "PICNIC_COUNTRY_CODE": "DE"
  783. }
  784. }
  785. }
  786. }
  787. ```
  788. **Wichtig**:
  789. - Ersetzen Sie `ihre-picnic-email@example.com` und `ihr-picnic-passwort` mit Ihren tatsächlichen Picnic-Kontodaten.
  790. - Für deutsche Accounts sollte `PICNIC_COUNTRY_CODE` auf `"DE"` gesetzt sein. Für niederländische Accounts setzen Sie es auf `"NL"`.
  791. 3. **Starten Sie Claude Desktop** vollständig neu
  792. 4. **Beginnen Sie mit der Nutzung** - Sie sollten ein 🔨 Hammer-Symbol im Eingabebereich sehen:
  793. ```
  794. "Ich möchte Mahlzeiten für diese Woche planen und Lebensmittel bei Picnic bestellen"
  795. ```
  796. ## Setup-Anweisungen
  797. ### Option 1: Von NPM installieren (Empfohlen)
  798. ```bash
  799. # Global installieren
  800. npm install -g mcp-picnic
  801. # Oder lokal in Ihrem Projekt installieren
  802. npm install mcp-picnic
  803. ```
  804. ### Option 2: Aus Quelle erstellen
  805. ```bash
  806. # Repository klonen
  807. git clone https://github.com/ivo-toby/mcp-picnic.git
  808. cd mcp-picnic
  809. # Abhängigkeiten installieren
  810. npm install
  811. # Projekt erstellen
  812. npm run build
  813. # Global verknüpfen (optional)
  814. npm link
  815. ```
  816. ## Authentifizierung
  817. Der Server verwendet die in Ihren Umgebungsvariablen konfigurierten Anmeldedaten:
  818. 1. **Erforderlich**: Setzen Sie `PICNIC_USERNAME` und `PICNIC_PASSWORD` in Ihrer MCP-Konfiguration
  819. 2. **Sitzungsspeicherung**: Nach erfolgreicher Authentifizierung wird Ihre Sitzung in `~/.picnic-session.json` gespeichert und bei Neustarts wiederverwendet. Sie können diesen Pfad mit der Umgebungsvariablen `PICNIC_SESSION_FILE` anpassen.
  820. ### Zwei-Faktor-Authentifizierung (2FA)
  821. Wenn Ihr Picnic-Konto 2FA aktiviert hat, müssen Sie die Verifizierung abschließen, bevor Sie die Einkaufs-Tools verwenden können. Bitten Sie bei Ihrem ersten Gespräch nach dem Start des Servers den KI-Assistenten:
  822. 1. **Einen 2FA-Code zu generieren**: Der Assistent ruft `picnic_generate_2fa_code` auf, um einen Verifizierungscode per SMS an Ihr Telefon zu senden
  823. 2. **Den Code einzugeben**: Teilen Sie dem Assistenten den erhaltenen Code mit, und er ruft `picnic_verify_2fa_code` auf, um die Authentifizierung abzuschließen
  824. Sobald die 2FA verifiziert ist, wird Ihre Sitzung gespeichert und Sie müssen diesen Schritt nicht wiederholen, bis die Sitzung abläuft.
  825. **Beispiel**:
  826. ```
  827. Benutzer: "Ich muss mein Picnic-Konto verifizieren"
  828. KI: Ich generiere einen 2FA-Code für Sie... Ein Code wurde per SMS an Ihr Telefon gesendet.
  829. Benutzer: "Der Code ist 123456"
  830. KI: Ihr 2FA-Code wurde verifiziert. Sie sind jetzt vollständig authentifiziert und können mit dem Einkaufen beginnen!
  831. ```
  832. **Sicherheitshinweis**: Ihre Anmeldedaten werden nur zur Authentifizierung mit Picnics API verwendet. Das Sitzungstoken wird lokal unter `~/.picnic-session.json` gespeichert. Ihr Passwort wird niemals auf der Festplatte gespeichert.
  833. ## Anwendungsfälle
  834. Hier sind einige praktische Szenarien, in denen MCP Picnic Ihr Lebensmitteleinkaufserlebnis transformieren kann:
  835. ### 📖 **Rezepte Durchstöbern**
  836. **Szenario**: Ein 20-Minuten-Rezept aus dem Picnic-Kochbuch wählen und die Zutaten ansehen
  837. ```
  838. Benutzer: "Zeig mir schnelle Wochentagsrezepte von Picnic und such ein Hähnchengericht aus"
  839. KI-Aktionen:
  840. 1. Verwendet picnic_browse_recipes (ohne Kategorie) für die Kochbuch-Highlights und verfügbaren Kategorie-Seiten
  841. 2. Verwendet picnic_browse_recipes mit category="20minuten" für alle Rezepte dieser Kategorie
  842. 3. Wählt ein Rezept mit Hähnchen im Titel und verwendet picnic_get_recipe mit der recipe id
  843. 4. Liest Zutatenliste, Vorratsgegenstände, Kochschritte und Rezepttipps
  844. 5. Speichert das Rezept optional mit picnic_save_recipe
  845. ```
  846. ### 🍽️ **Intelligente Mahlzeitenplanung**
  847. **Szenario**: Eine Woche voller gesunder Mahlzeiten für eine 4-köpfige Familie planen
  848. ```
  849. Benutzer: "Plane 7 Abendessen für 4 Personen, Fokus auf mediterrane Diät, Budget €100"
  850. KI-Aktionen:
  851. 1. Verwendet picnic_search um mediterrane Zutaten zu finden
  852. 2. Verwendet picnic_get_suggestions für Rezeptideen
  853. 3. Verwendet picnic_add_to_cart um Einkaufsliste zu erstellen
  854. 4. Verwendet picnic_get_cart um Gesamtkosten zu überprüfen
  855. 5. Verwendet picnic_get_delivery_slots um Lieferung zu planen
  856. ```
  857. ### 🛒 **Intelligenter Einkaufsassistent**
  858. **Szenario**: Ein spezifisches Rezept mit Diät-Ersatzstoffen nachkochen
  859. ```
  860. Benutzer: "Ich möchte Lasagne machen, brauche aber glutenfreie und milchfreie Alternativen"
  861. KI-Aktionen:
  862. 1. Verwendet picnic_search um glutenfreie Pasta zu finden
  863. 2. Verwendet picnic_get_suggestions für milchfreie Käse-Alternativen
  864. 3. Verwendet picnic_get_product_details um Zutatdetails zu prüfen
  865. 4. Verwendet picnic_add_to_cart um geeignete Produkte hinzuzufügen
  866. 5. Gibt Kochtipps und Ersatzverhältnisse
  867. ```
  868. ### 📦 **Lieferoptimierung**
  869. **Szenario**: Mehrere Lieferungen verwalten und Bestellungen verfolgen
  870. ```
  871. Benutzer: "Wie ist der Status all meiner Bestellungen und wann kommen sie an?"
  872. KI-Aktionen:
  873. 1. Verwendet picnic_get_deliveries um alle aktuellen Bestellungen anzuzeigen
  874. 2. Verwendet picnic_get_delivery_position für Echtzeit-Tracking
  875. 3. Verwendet picnic_get_delivery_scenario für Fahrerdetails
  876. 4. Schlägt optimale Lieferzeiten mit picnic_get_delivery_slots vor
  877. 5. Sendet Rechnungs-E-Mails mit picnic_send_delivery_invoice_email
  878. ```
  879. ### 💰 **Budgetbewusstes Einkaufen**
  880. **Szenario**: Innerhalb eines strengen Budgets einkaufen und dabei Qualität beibehalten
  881. ```
  882. Benutzer: "Ich habe €50 für Lebensmittel diese Woche, hilf mir den Wert zu maximieren"
  883. KI-Aktionen:
  884. 1. Verwendet picnic_search um budgetfreundliche Grundnahrungsmittel zu finden
  885. 2. Verwendet picnic_get_product_details um Preise, Packungsgrößen und Aktionen zu prüfen
  886. 3. Verwendet picnic_get_cart um laufende Gesamtsumme zu verfolgen
  887. 4. Verwendet picnic_remove_from_cart wenn Budget überschritten wird
  888. 5. Verwendet picnic_get_wallet_transactions um Ausgabenmuster zu verfolgen
  889. ```
  890. ### 🏠 **Haushaltsmanagement**
  891. **Szenario**: Einkaufslisten für verschiedene Familienmitglieder verwalten
  892. ```
  893. Benutzer: "Erstelle separate Einkaufslisten für wöchentliche Lebensmittel und Partybedarf"
  894. KI-Aktionen:
  895. 1. Verwendet picnic_search um wöchentliche Grundnahrungsmittel zu finden
  896. 2. Verwendet picnic_search um party-spezifische Artikel zu finden
  897. 3. Verwendet picnic_get_product_details um Packungsgrößen und Zutaten zu prüfen
  898. 4. Verwendet picnic_add_to_cart wenn bereit zum Bestellen
  899. 5. Verwendet picnic_get_cart um Gesamtsummen vor dem Checkout zu prüfen
  900. ```
  901. ### 🎉 **Veranstaltungsplanung**
  902. **Szenario**: Ein Abendessen für 12 Gäste planen
  903. ```
  904. Benutzer: "Ich veranstalte ein Abendessen für 12 Personen nächsten Samstag, hilf mir planen"
  905. KI-Aktionen:
  906. 1. Verwendet picnic_search um Vorspeisen, Hauptgerichte und Dessert-Zutaten zu finden
  907. 2. Verwendet picnic_get_suggestions für Weinpaarungen
  908. 3. Verwendet picnic_get_delivery_slots um Freitag-Lieferung zu planen
  909. 4. Verwendet picnic_set_delivery_slot um optimale Zeit zu buchen
  910. 5. Verwendet picnic_get_product_details um Produktverfügbarkeit und Größen zu prüfen
  911. ```
  912. ### 🥗 **Gesundheits- & Diätmanagement**
  913. **Szenario**: Spezifische Diätanforderungen verwalten (Diabetes, Allergien)
  914. ```
  915. Benutzer: "Finde kohlenhydratarme Optionen für ein diabetikerfreundliches Wochenmenü"
  916. KI-Aktionen:
  917. 1. Verwendet picnic_search mit spezifischen Diät-Suchbegriffen
  918. 2. Verwendet picnic_get_product_details um Nährwertinformationen zu prüfen
  919. 3. Verwendet picnic_get_suggestions für gesunde Alternativen
  920. 4. Verwendet picnic_add_to_cart nur für genehmigte Artikel
  921. 5. Verfolgt Ernährungsziele über mehrere Mahlzeiten
  922. ```
  923. ### 📱 **Intelligente Nachbestellung**
  924. **Szenario**: Automatische Nachbestellung von Haushaltsessentials
  925. ```
  926. Benutzer: "Bestelle meine üblichen wöchentlichen Essentials nach und füge neue saisonale Artikel hinzu"
  927. KI-Aktionen:
  928. 1. Verwendet picnic_get_user_details um Kaufhistorie zu prüfen
  929. 2. Verwendet picnic_get_wallet_transactions um regelmäßige Käufe zu identifizieren
  930. 3. Verwendet picnic_search um saisonale Produkte zu finden
  931. 4. Verwendet picnic_add_to_cart für sowohl reguläre als auch neue Artikel
  932. 5. Verwendet picnic_get_delivery_slots für bequeme Planung
  933. ```
  934. ### 🎯 **Preisvergleich & Optimierung**
  935. **Szenario**: Die besten Wertprodukte in verschiedenen Kategorien finden
  936. ```
  937. Benutzer: "Vergleiche Preise für Bio- vs. konventionelles Gemüse diese Woche"
  938. KI-Aktionen:
  939. 1. Verwendet picnic_search für sowohl Bio- als auch konventionelle Artikel
  940. 2. Verwendet picnic_get_product_details um Preise und Größen zu vergleichen
  941. 3. Verwendet picnic_get_suggestions für ähnliche Marken und Produkte
  942. 4. Verwendet picnic_get_cart um Warenkorbsummen zu vergleichen
  943. 5. Bietet detaillierte Kostenanalyse und Empfehlungen
  944. ```
  945. ### 🚚 **Liefererfahrungsmanagement**
  946. **Szenario**: Liefererfahrung optimieren und Feedback geben
  947. ```
  948. Benutzer: "Verfolge meine Lieferung und bewerte die Servicequalität"
  949. KI-Aktionen:
  950. 1. Verwendet picnic_get_delivery_position für Echtzeit-Tracking
  951. 2. Verwendet picnic_get_delivery_scenario für Fahrerkommunikation
  952. 3. Verwendet picnic_rate_delivery nach Abschluss
  953. 4. Verwendet picnic_send_delivery_invoice_email für Aufzeichnungen
  954. 5. Verwendet picnic_get_order_status um den endgültigen Bestellstatus zu bestätigen
  955. ```
  956. ### 💳 **Finanzielle Verfolgung**
  957. **Szenario**: Lebensmittelbudget verwalten und Zahlungsmethoden optimieren
  958. ```
  959. Benutzer: "Zeige mir meine Lebensmittelausgabenmuster und optimiere meine Zahlungseinstellungen"
  960. KI-Aktionen:
  961. 1. Verwendet picnic_get_wallet_transactions für Ausgabenanalyse
  962. 2. Verwendet picnic_get_wallet_transaction_details für detaillierte Aufschlüsselungen
  963. 3. Verwendet picnic_get_payment_profile um Zahlungsmethoden zu überprüfen
  964. 4. Bietet Einblicke in Ausgabentrends und Budgetoptimierung
  965. 5. Schlägt kostensparende Strategien basierend auf Kaufhistorie vor
  966. ```
  967. Diese Anwendungsfälle zeigen, wie MCP Picnic einfaches Lebensmitteleinkaufen in eine intelligente, personalisierte Erfahrung verwandelt, die Zeit, Geld und Aufwand spart und dabei sicherstellt, dass Sie nie wichtige Artikel oder optimale Angebote verpassen.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.