Woolworths MCP Server

A Model Context Protocol (MCP) server for interacting with Woolworths Australia’s online shopping platform. This server provides tools for browsing products, searching items, viewing specials, and more.

Features

• Browser Automation: Uses Puppeteer to open a browser, navigate to Woolworths, and capture session cookies
• Session Management: Maintains session cookies for authenticated API requests
• Product Search: Search for products across the Woolworths catalog with filtering and sorting
• Product Details: Get detailed information about specific products
• Specials & Deals: Browse current specials and promotional offers
• Category Browsing: Explore product categories
• Shopping Cart: Add items to cart, view cart contents, update quantities, and remove items

Installation

1. Install dependencies:

npm install

2. Build the TypeScript code:

npm run build

Usage

Running the Server

The MCP server runs on stdio and is designed to be used with MCP-compatible clients (like Claude Desktop, Cline, or other AI assistants).

npm start

Configuration for Claude Desktop

Add this to your Claude Desktop configuration file:

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

{
  "mcpServers": {
    "woolworths": {
      "command": "node",
      "args": ["C:\\Users\\eglass\\Projects\\Woolworths\\dist\\index.js"]
    }
  }
}

Make sure to update the path to match your installation directory.

Available Tools

1. woolworths_open_browser

Opens a browser and navigates to the Woolworths website. This is typically the first step to establish a session.

Parameters:

• headless (boolean, optional): Whether to run in headless mode (default: false)

Example:

{
  "headless": false
}

2. woolworths_navigate

Navigate to a specific URL on the Woolworths website.

Parameters:

• url (string, required): The URL to navigate to

3. woolworths_get_cookies

Retrieves and stores session cookies from the current browser session. Run this after logging in or when you have an active session.

Parameters: None

4. woolworths_close_browser

Closes the browser instance while preserving the captured session cookies.

Parameters: None

5. woolworths_search_products

Search for products on Woolworths.

Parameters:

• searchTerm (string, required): The product search term
• pageSize (number, optional): Number of results to return (default: 20)

Example:

{
  "searchTerm": "milk",
  "pageSize": 20
}

6. woolworths_get_product_details