Willys MCP Server

An MCP (Model Context Protocol) server for Willys — Sweden’s largest grocery chain. Control your shopping cart, browse orders, search products, and get AI-powered recommendations directly from Claude Code or any MCP client.

Features

• 19 MCP Tools — Cart, orders, search, delivery slots, promotions, and more
• Smart Matching — AI-powered product recommendations using your purchase history (OpenAI embeddings + sqlite-vec)
• Web Interface — Next.js app for browsing orders and testing features
• Persistent Sessions — SQLite-backed with 24h expiration
• Order Caching — Reduces API calls by 80-90%

Quick Start

git clone https://github.com/yourusername/willys-checklist.git
cd willys-checklist
npm install

Create .credentials in the project root:

[email protected]
your-password

Claude Code Integration

Add to ~/.claude.json:

{
  "mcpServers": {
    "willys-checklist": {
      "type": "stdio",
      "command": "npx",
      "args": ["tsx", "/absolute/path/to/willys-checklist/mcp-server.ts"]
    }
  }
}

Restart Claude Code. Then just ask:

“Log in to Willys and show me my cart” “Search for havremjölk” “What did I order last week?” “Add Oatly Barista to my cart”

Web Interface

npm run dev

Open http://localhost:3000

MCP Tools

Auth

Cart

Orders

Search

Delivery

Other

Smart Product Matching

Enable AI-powered recommendations by setting:

export OPENAI_API_KEY=sk-...

The system uses your purchase history + semantic search to find products you’re likely to want.

Project Structure

├── mcp-server.ts           # Stdio MCP server
├── app/                    # Next.js web UI
├── lib/
│   ├── database.ts         # SQLite layer
│   ├── mcp-auth.ts         # Puppeteer login
│   ├── mcp-orders.ts       # API operations
│   ├── mcp-session-store.ts
│   ├── embeddings.ts       # OpenAI embeddings
│   └── types.ts
├── actions/                # Server actions
└── components/             # React components

Development

npm run dev      # Dev server (port 3000)
npm run lint     # Biome check
npm run format   # Biome format

Notes

• Product codes: 101175556_ST format
• Full Swedish character support (ö, ä, å)
• Sessions expire after 24 hours
• CSRF handling built-in

Troubleshooting

MCP not connecting? Check the path in ~/.claude.json is absolute. Verify npx tsx works.

Login fails? Check .credentials file. Puppeteer may need deps on Linux.

Smart matching empty? Set OPENAI_API_KEY. First run indexes history.

License

MIT License

Copyright © 2025

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

---

Disclaimer: Not affiliated with Willys or Axfood. Use responsibly.