waitrose-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
waitrose-mcp
An unofficial, self-hosted MCP server for shopping on your own Waitrose account. The source code is public; run the server privately. It uses the Waitrose mobile app API through the vendored jonastemplestein/waitrose client (MIT license). This project is not affiliated with or endorsed by Waitrose.
Checkout stays in Waitrose. The MCP server exposes no tools for placing, paying for, cancelling, or starting an amendment of an order. Trolley and slot writes, when enabled, can affect the account's active trolley or an order already being amended in Waitrose.
Terms of use
The server uses a private API that Waitrose can change or block at any time. Check Waitrose's terms before use and keep requests infrequent. It is intended for personal use on your own account.
Related MCP server: Basketeer
Tools
Read tools are always available.
Tool | What it does |
| Search the catalogue for names, prices, sizes and line numbers |
| Browse categories (start at |
| View product details, including ingredients and nutrition where available |
| View the current trolley, totals and conflicts |
| View pending and past orders |
| View the booked delivery or collection slot |
| List available slots and charges |
Write tools are disabled by default. Their MCP annotations identify them as writes; confirmation behavior depends on the client. Confirm the exact change before running one. Check the Waitrose app before retrying a write that returned an error.
Tool | Required setting | What it changes |
|
| Adds items to the trolley |
|
| Changes quantities; zero removes the item |
|
| Removes an item |
| Both write and slot booking flags | Reserves a slot; delivery charges may apply |
Setup
Use Node.js 22 or later, a Waitrose account and a client that supports MCP Streamable HTTP.
npm ci --ignore-scripts
npm run build
cp .env.example .envEdit the ignored .env file with your Waitrose login and a random bearer token
(for example, generate one with openssl rand -hex 32). Start with both write
flags off.
node --env-file=.env dist/src/server.jsIf your environment already supplies the variables, use npm start after
building. The default MCP endpoint is http://127.0.0.1:3000/mcp; send
Authorization: Bearer <your token>. GET /health is unauthenticated and
reports only server status and whether write flags are enabled.
Variable | Meaning |
| Required for Waitrose calls. The server signs in lazily; restart it to refresh an expired session. |
| Required unless the loopback only mode below is enabled. |
| Set to |
| Set to |
| Defaults: |
| Set to |
The server accepts native clients and server-to-server connections. It rejects
browser requests with an Origin header. In loopback only mode the client or
proxy must send the local endpoint's hostname and port as the Host header.
Connecting from ChatGPT
Follow OpenAI's custom MCP server setup, subject to your account and workspace policies. For a private server, use a Secure MCP Tunnel to the loopback endpoint. If your client cannot supply a static bearer token, let the authenticated tunnel or an OAuth proxy control access and use the loopback only mode for the local connection. Avoid exposing the upstream listener directly: even read tools return private account data.
Testing
Run npm test after npm ci --ignore-scripts. The suite drives the MCP server
over local HTTP with a mocked Waitrose API. It checks authentication, write
gates, login, search, trolley reads and writes, and slot listing and booking.
CI runs it on Node.js 22 and 24.
Live Waitrose compatibility has not been verified. Start with both write flags
off and compare results from waitrose_search, waitrose_get_trolley, and
waitrose_list_slot_days with the Waitrose app. For a separate trolley write
check, use a product that is not already in the trolley and only test when no
order is being amended. Add one, verify it in Waitrose, then remove it and
verify the trolley returned to its starting state. Booking a slot is not a
routine smoke test.
Files
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read and edit your Kori grocery lists: add, check off, edit and remove items.
Recipes, meal plan, shopping list and pantry from the Stemma iOS app, with per-area OAuth scopes.
teas.co.uk is an independent UK shop with more than 600 teas, coffees and hot chocolates from 60 brands. This connector searches the live catalogue in plain words, such as a strong breakfast tea or something caffeine free for bedtime, with filters for type, caffeine, milk, time of day, strength, pack size, price per cup and organic, Fairtrade or vegan labels, and shows live prices and stock. Open any product for tasting notes, a brewing guide and recipe ideas, or compare up to four side by side. Build a basket and get a secure checkout link: payment always happens on teas.co.uk, never in the chat, and the connector cannot place an order. Customers who link their teas.co.uk account (OAuth) can see orders and courier tracking, buy again, manage repeat deliveries, check reward points and start a return. teas.co.uk delivers to the UK, the Channel Islands, the Isle of Man and many European countries; prices are in pounds including VAT.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables interaction with Woolworths Australia's online shopping platform through browser automation and API integration. Supports product search, browsing specials, managing shopping cart, and accessing product details through natural language.81218GPL 3.0
- AlicenseNot gradedqualityBmaintenancePersonal UK Tesco grocery account over MCP: search, basket, slots, orders, and on-pack nutrition (search and rank by macros + micros). Catalogue + nutrition tools need no auth; destructive actions require a two-step confirm292 npm20MIT
- AlicenseAqualityBmaintenanceEnables browsing and searching the Woolworths New Zealand grocery catalogue, retrieving product details, checking specials, and managing a shopping trolley with optional account sign-in.184MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to search the catalog, manage a cart and usual orders, find delivery slots, and handle favorites, shopping lists, past orders, and item remarks through the store's API, with login and payment left to the user on the website.MIT