Coles Woolworths MCP Server

An experimental Model Context Protocol (MCP) server implementation that allows AI assistants to search for product information from Australia's major

Local serverstdioPython

What is the Coles Woolworths MCP server?

Coles woolworths mcp server connects Coles Woolworths to AI assistants that speak the Model Context Protocol. An experimental Model Context Protocol (MCP) server implementation that allows AI assistants to search for product information from Australia's major supermarkets: Coles and Woolworths. This server exposes product search functionality through the MCP protocol, making it easy for AI assistants to.

What Coles Woolworths does

An experimental Model Context Protocol (MCP) server implementation that allows AI assistants to search for product information from Australia's major supermarkets: Coles and Woolworths. This server exposes product search functionality through the MCP protocol, making it easy for AI assistants to retrieve product pricing and details.

Key capabilities

  • Product Search — Search for products at both Coles and Woolworths supermarkets
  • Price Comparison — Get pricing information from both retailers in a consistent format
  • Store Selection — Search specific Coles stores using store IDs
  • Result Limiting — Control how many products are returned in search results

Tools it exposes

Once connected, the assistant can call these 4 tools directly:

  • get_coles_products — Search for products at Coles supermarkets with optional store selection
  • get_woolworths_products — Search for products at Woolworths supermarkets
  • Prerequisites — The Prerequisites tool exposed by this server
  • Setup — 1. Clone the repository and navigate to the project directory 2. Use uv to install dependencies:

Installing the coles woolworths mcp server

The server is distributed via PyPI as fastmcp, so most clients can run it without a manual build step. Add it to your MCP client's configuration and restart the client to pick it up — the copy-paste configs for Claude Desktop, Claude Code and Cursor are on this page.

Configuration

Before the server will start you need to supply one environment variable: COLES_API_KEY. Keep credentials in your client's env block or a secrets manager rather than committing them.

Requirements

  1. Python 3.8 or higher 2. The uv package manager

Where it fits

File and storage servers are what separate an assistant that talks about your documents from one that actually works with them. Coles Woolworths sits in that group, and the shape of its toolset — get_coles_products, get_woolworths_products, Prerequisites among others — tells you what it is really for. Worth comparing against the other file systems servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.

Practical notes

  • This server runs locally, so it operates with whatever access your machine and its credentials already have. Scope that deliberately rather than by default.
  • It will not start until its required credentials are present, so set those before wondering why the tools never appear.
  • Maintained by hung-ngm, written in Python.
  • MCP clients ask for confirmation before each tool call by default. Keep that on while you learn what the coles woolworths mcp server actually does with your data.
  • Every entry in this directory is reviewed by hand before it goes live, and details are checked against the project's own documentation.

Available tools

ToolWhat it does
get_coles_productsSearch for products at Coles supermarkets with optional store selection
get_woolworths_productsSearch for products at Woolworths supermarkets
PrerequisitesThe Prerequisites tool exposed by this server.
Setup1. Clone the repository and navigate to the project directory 2. Use uv to install dependencies:

How to install the Coles Woolworths MCP server

{
  "mcpServers": {
    "coles-woolworths": {
      "command": "uvx",
      "args": ["fastmcp"],
      "env": {
        "COLES_API_KEY": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  1. Python 3.8 or higher 2. The uv package manager
VariableDescriptionRequired
COLES_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Coles Woolworths to get coles products.
  • Use Coles Woolworths to get woolworths products.
  • Use Coles Woolworths to Prerequisites.

Frequently asked questions

It connects Coles Woolworths to MCP-compatible AI assistants such as Claude and Cursor, exposing 4 tools (get_coles_products, get_woolworths_products, Prerequisites, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Coles Woolworths directly.