Coles and Woolworths MCP Server
About
Search for products and compare prices at Coles and Woolworths supermarkets in Australia.
Details
- Author
- hung-ngm
- Categories
- Search, Other, Web Scraping
Jump to
Quick Start for Claude Desktop, Cursor, and other clients
git clone https://github.com/hung-ngm/coles-woolworths-mcp-server.git
Configure your MCP client to use this server (see](https://github.com/user-attachments/assets/0af3b07a-578a-4112-acfe-e7a7eee31161)Integrating with MCP Clients)
- Python 3.8 or higher
- Theuvpackage manager
uv is a fast Python package installer and resolver. To install:
curl -LsSf https://astral.sh/uv/install.sh | sh
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
- Clone the repository and navigate to the project directory
- Useuvto install dependencies:
# Install dependencies uv pip install fastmcp requests python-dotenv
The server uses the following environment variables:
- COLES_API_KEY: API key for accessing the Coles API (required for Coles product searches)
You can set these variables in a.envfile in the project directory.
To run the Coles and Woolworths MCP server directly usinguv:
By default, the server runs with stdio transport for MCP client integration.
To use the Coles and Woolworths MCP server with Claude Desktop:
- Locate your Claude Desktop configuration file (usuallyclaude_desktop_config.json)
- Add the following configuration to themcpServerssection:
{ "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" ] } } }
Replace/full/path/to/coles-woolies-mcp/main.pywith the absolute path to your main.py file.
- Restart Claude Desktop for the changes to take effect
- Open your Cursor configuration file
- Add the following to themcpServerssection:
{ "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" ] } } }
The Coles and Woolworths MCP server exposes the following tools:
- get_coles_products: Search for products at Coles supermarkets with optional store selection
- get_woolworths_products: Search for products at Woolworths supermarkets
You can use the tools in Claude like this:
Could you check the price of Cadbury chocolate at both Coles and Woolworths?
Claude will then use the appropriate tools to search for the products and return the results.
- Python 3.8 or higher
- fastmcp package
- requests package
- python-dotenv package
- MCP-compatible client (Claude Desktop, Cursor, etc.)
Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.
Query computer component prices from Taiwan's CoolPC website to generate AI-assisted price quotes.
A product search server that provides markdown-formatted responses with clickable product links and prices.
Scrapes and searches for products on Amazon.
An MCP server that connects AI agents to Amazon product, search, and review data across 20 marketplaces via the ChocoData Amazon Scraper API.
French gluten-free product catalog and comparisons for celiac shoppers - verified prices, buyer ratings. Remote server at https://gluten-free.fr/api/mcp
One MCP server for 160+ live web-data APIs (search, social, e-commerce, real estate, jobs, finance) — clean JSON, free tier.
Automates shopping on the Shufersal website, enabling LLMs to search for products, create shopping lists, and manage the cart.
MCP server for Amazon shopping - AI agents can search products, check prices, add to cart, and manage shopping lists.
One API for Search, Crawling, and Sitemaps
enables searching and booking car rentals
Search for products and compare prices at Coles and Woolworths supermarkets in Australia.
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.
https://github.com/user-attachments/assets/0af3b07a-578a-4112-acfe-e7a7eee31161
- 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
Quick Start for Claude Desktop, Cursor, and other clients
git clone https://github.com/hung-ngm/coles-woolworths-mcp-server.git
Configure your MCP client to use this server (seeIntegrating with MCP Clients)
- Python 3.8 or higher
- Theuvpackage manager
uv is a fast Python package installer and resolver. To install:
curl -LsSf https://astral.sh/uv/install.sh | sh
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
- Clone the repository and navigate to the project directory
- Useuvto install dependencies:
# Install dependencies uv pip install fastmcp requests python-dotenv
The server uses the following environment variables:
- COLES_API_KEY: API key for accessing the Coles API (required for Coles product searches)
You can set these variables in a.envfile in the project directory.
To run the Coles and Woolworths MCP server directly usinguv:
By default, the server runs with stdio transport for MCP client integration.
To use the Coles and Woolworths MCP server with Claude Desktop:
- Locate your Claude Desktop configuration file (usuallyclaude_desktop_config.json)
- Add the following configuration to themcpServerssection:
{ "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" ] } } }
Replace/full/path/to/coles-woolies-mcp/main.pywith the absolute path to your main.py file.
- Restart Claude Desktop for the changes to take effect
- Open your Cursor configuration file
- Add the following to themcpServerssection:
{ "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" ] } } }
The Coles and Woolworths MCP server exposes the following tools:
- get_coles_products: Search for products at Coles supermarkets with optional store selection
- get_woolworths_products: Search for products at Woolworths supermarkets
You can use the tools in Claude like this:
Could you check the price of Cadbury chocolate at both Coles and Woolworths?
Claude will then use the appropriate tools to search for the products and return the results.
- Python 3.8 or higher
- fastmcp package
- requests package
- python-dotenv package
- MCP-compatible client (Claude Desktop, Cursor, etc.)
Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.
Query computer component prices from Taiwan's CoolPC website to generate AI-assisted price quotes.
A product search server that provides markdown-formatted responses with clickable product links and prices.
Scrapes and searches for products on Amazon.
An MCP server that connects AI agents to Amazon product, search, and review data across 20 marketplaces via the ChocoData Amazon Scraper API.
French gluten-free product catalog and comparisons for celiac shoppers - verified prices, buyer ratings. Remote server at https://gluten-free.fr/api/mcp
One MCP server for 160+ live web-data APIs (search, social, e-commerce, real estate, jobs, finance) — clean JSON, free tier.
Automates shopping on the Shufersal website, enabling LLMs to search for products, create shopping lists, and manage the cart.
MCP server for Amazon shopping - AI agents can search products, check prices, add to cart, and manage shopping lists.
One API for Search, Crawling, and Sitemaps
enables searching and booking car rentals
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
