MCP Picnic Server

MCP Picnic is an AI-facing server that connects your MCP-compatible assistant to Picnic, the online grocery delivery service. It lets you search products, manage your cart, plan meals, track deliveries, and receive dietary-friendly recommendations through natural conversation, turning grocery shopping into an intelligent, automated workflow you control.

How to use

You connect an MCP-compatible AI assistant to MCP Picnic and start conversations to plan meals, add items to your cart, check delivery slots, and track orders. Use natural language to ask for meal plans, budget-friendly shopping, substitutions for dietary needs, or to reorder staples. The assistant will perform actions such as searching Picnic catalogs, adding items to your cart, selecting delivery windows, and monitoring delivery progress.

A typical use pattern looks like this: you describe what you want (for example, a week of meals within a budget) and the assistant searches for ingredients, builds a shopping list, adds items to the cart, checks total cost, and books a delivery slot. You can also ask for specific dietary options, substitution ideas, or meal ideas that align with your preferences.

How to install

Prerequisites you need before installing MCP Picnic are a Picnic account, an MCP-compatible AI assistant, and Node.js 18 or newer installed on your system.

# Install the MCP Picnic server globally
npm install -g mcp-picnic

# Or install locally in your project
npm install mcp-picnic

Configuration and setup notes

To enable the MCP Picnic server and wire it into your assistant, you will provide your Picnic credentials and country code as environment variables in your MCP client 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"
    }
  }
}

Authentication and security

The server uses the credentials configured in your environment variables to authenticate with Picnic's API. Two-factor authentication, if enabled on your account, is handled automatically, and your session is maintained for subsequent requests. Credentials are not stored permanently and are transmitted securely via environment variables.

Troubleshooting tips

If you encounter connection issues, verify that your environment variables are correctly set in the MCP client configuration and that the server process is running. Check that the Node.js version is 18 or newer and that your Picnic account country code matches your account region.

Available tools

picnic_generate_2fa_code

Generate a two-factor authentication code for login if 2FA is enabled on your Picnic account.

picnic_verify_2fa_code

Verify the 2FA code during authentication.

picnic_get_user_details

Fetch the current user profile information.

picnic_get_user_info

Retrieve user information including feature toggles.

picnic_search

Search Picnic's catalog by product name or keywords.

picnic_get_suggestions

Obtain product suggestions based on a query.

picnic_get_article

Get detailed information about a specific product.

picnic_get_image

Retrieve product images in various sizes.

picnic_get_categories

Browse product categories with configurable depth.

picnic_get_cart

View current shopping cart contents and totals.

picnic_add_to_cart

Add products to the cart with specified quantities.

picnic_remove_from_cart

Remove products from the cart with specified quantities.

picnic_clear_cart

Clear all items from the shopping cart.

picnic_get_delivery_slots

View available delivery time slots.

picnic_set_delivery_slot

Book a delivery time slot.

picnic_get_deliveries

List past and current deliveries with filters.

picnic_get_delivery

Get detailed information about a specific delivery.

picnic_get_delivery_position

Track real-time driver location and ETA.

picnic_get_delivery_scenario

Get driver and route information.

picnic_cancel_delivery

Cancel a scheduled delivery.

picnic_rate_delivery

Rate completed deliveries on a 0-10 scale.

picnic_send_delivery_invoice_email

Send delivery invoice emails.

picnic_get_order_status

Check the status of specific orders.

picnic_get_lists

Retrieve shopping lists and sublists.

picnic_get_list

Get a specific list or sublist with items.

picnic_get_payment_profile

View payment methods and billing information.

picnic_get_wallet_transactions

Fetch wallet transaction history.

picnic_get_wallet_transaction_details

Get detailed wallet transaction information.

picnic_get_mgm_details

Retrieve MGM (friend discount) program details.