coles-woolworths-mcp-server

hung-ngm/coles-woolworths-mcp-server

3.3

If you are the rightful owner of coles-woolworths-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

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.

The Coles and Woolworths MCP Server is a cutting-edge solution designed to facilitate seamless access to product information from two of Australia's leading supermarket chains. By leveraging the Model Context Protocol (MCP), this server enables AI assistants to efficiently retrieve and compare product details and pricing from Coles and Woolworths. This server is particularly useful for applications that require real-time product data, such as price comparison tools, shopping assistants, and inventory management systems. The server is built with Python and utilizes the fastmcp, requests, and python-dotenv packages to ensure robust and reliable performance. Users can easily integrate this server with various MCP-compatible clients, including Claude Desktop and Cursor IDE, to enhance their applications with comprehensive supermarket data.

Features

  • 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.

Usages

usage with Claude Desktop

{
  "mcpServers": {
    "coles-woolies-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fastmcp",
        "--with",
        "requests",
        "--with", 
        "python-dotenv",
        "fastmcp",
        "run",
        "/full/path/to/coles-woolies-mcp/main.py"
      ]
    }
  }
}

usage with Cursor IDE

{
  "mcpServers": {
    "coles-woolies-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fastmcp",
        "--with",
        "requests",
        "--with", 
        "python-dotenv",
        "fastmcp",
        "run",
        "/full/path/to/coles-woolies-mcp/main.py"
      ]
    }
  }
}

Tools

  1. get_coles_products

    Search for products at Coles supermarkets with optional store selection.

  2. get_woolworths_products

    Search for products at Woolworths supermarkets.