mcp-homedepot
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-homedepot I need to find a cordless drill"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-homedepot
A Model Context Protocol server for Home Depot Canada (homedepot.ca). It exposes the store's product catalogue — search, product detail, store-level stock and a store finder — to MCP clients such as Claude and Cursor.
Unofficial. This project is not affiliated with, endorsed by, or sponsored by The Home Depot. It reads publicly available endpoints of homedepot.ca for personal, noncommercial use. Respect Home Depot's terms of service and use responsibly.
Tools
Tool | Description |
| Product search / listings by keyword. Returns products (SKU, name, brand, model, price, rating, online stock, URL, image), total count, facets and sort options. |
| Full product card by SKU: name, brand, model, description, images, rating/reviews, warranty, categories, price, in-store stock + aisle/bay, online stock, fulfillment options. |
| In-store stock of a SKU across a store and its nearby stores, sorted in-stock first. Per store: name, address, phone, coordinates, stock level/status, aisle/bay, pickup status. |
| Store directory / find stores near a postal code (geocoded → distance-sorted with |
More tools (suggestions, categories) are planned.
hd_search
Param | Type | Default | Notes |
| string | — | Search keyword (required). |
| string |
| Store id for store-specific stock/pricing. |
|
|
| Response language. |
|
|
| Sort order. |
| int |
| 0-indexed page. |
| int (1–60) |
| Results per page. |
hd_product
Param | Type | Default | Notes |
| string | — | Product SKU / code (required), e.g. |
| string | — | Postal code, e.g. |
| string |
| Store id for store-specific price/stock/aisle. Override default with |
|
|
| Response language. |
hd_store_availability
Param | Type | Default | Notes |
| string | — | Product SKU / code (required). |
| string | — | Postal code; nearby stores are taken around it (overrides |
| string |
| Reference store; nearby stores are taken from it. |
|
|
| Response language. |
| int (1–20) |
| Max number of stores to check. |
Default store: product/availability tools default to store
7074(Langford, BC). SetHD_DEFAULT_STOREenv var, or passstoreId, to use your local store. Usehd_storeswith a postal code to find the right store id.
hd_stores
Param | Type | Default | Notes |
| string | — | Canadian postal code, e.g. |
| number | — | Alternative to |
|
|
| Response language. |
| int (1–200) | 20 / all | Max stores. Default 20 for a proximity search, all (~183) otherwise. |
The store API geosorts by coordinates only, so a postal code is first geocoded via
api.zippopotam.us(free, no key).distanceKmis computed locally (haversine).
Related MCP server: FireBall1725/pcexpress-mcp-server
How it talks to Home Depot
homedepot.ca/api/* is behind Akamai Bot Manager, which gates on both the
HTTP version and the client's TLS (JA3) fingerprint. Node's native HTTP stack
(fetch/undici, node:http2) gets 403. Only curl --http2 is
allowlisted, so every request shells out to curl. No cookies are needed for
the public search APIs.
Requirement: curl with HTTP/2 support must be on PATH (standard on macOS
and most Linux distros).
Build & run
npm install
npm run build
npm start # runs the MCP server on stdioQuick smoke test of the search layer:
node --input-type=module -e 'import {search} from "./dist/search.js"; console.log(await search({query:"drill", pageSize:3}))'Inspect with the MCP Inspector:
npm run inspectConnecting a client
Add to your MCP client config (e.g. Claude Desktop claude_desktop_config.json),
pointing at the built entrypoint:
{
"mcpServers": {
"homedepot": {
"command": "node",
"args": ["/absolute/path/to/mcp_homedepot/dist/index.js"],
"env": { "HD_DEFAULT_STORE": "7074" }
}
}
}HD_DEFAULT_STORE is optional (defaults to 7074, Langford BC).
Project layout
src/
index.ts MCP server + tool registration (stdio)
hd.ts curl --http2 transport for homedepot.ca
search.ts hd_search implementation + response mapping
product.ts hd_product + hd_store_availability (summary, buybox, storesvc APIs)
stores.ts hd_stores (store directory + postal-code geocode → nearest)License
PolyForm Noncommercial License 1.0.0 — free to use, modify and share for noncommercial purposes. Commercial use requires a separate license from the author.
Available Tools
4 toolshd_productGet Home Depot Canada product by SKUA
Fetch the full product card for a Home Depot Canada SKU (product code): name, brand, model, description, images, rating/reviews, warranty, categories, price, in-store stock with aisle/bay location, online stock, and fulfillment options (pickup in store, ship to store, ship to home, express delivery) for a given store.
Inputs: sku (required), postalCode, storeId, lang.
hd_searchSearch Home Depot CanadaA
Search Home Depot Canada (homedepot.ca) for products by keyword. Returns matching products with SKU, name, brand, model, price, rating, online stock, URL and image, plus the total result count, available filters (facets) and sort options. Use page to paginate.
Inputs: query (required), storeId, lang, sort, +2 more.
hd_store_availabilityCheck Home Depot Canada store availability for a SKUA
Check in-store stock of a Home Depot Canada SKU across a store and its nearby stores. Returns, per store: store name, address, phone, coordinates, stock level/status, aisle/bay location, and pickup status. Sorted with in-stock stores first. Use to answer 'which store has this in stock near me'.
Inputs: sku (required), postalCode, storeId, lang, +1 more.
hd_storesHome Depot Canada store directory / find stores by postal codeA
List Home Depot Canada stores. With postalCode, returns stores nearest to it first (use to find a store id for hd_product / hd_store_availability). Without postalCode, returns the full national store directory (all ~183 stores). Each store: id, name, address, town, province, postal code, phone, coordinates, URL, and fulfillment eligibility (pickup in store / ship to store / ship from store).
Inputs: postalCode, latitude, longitude, lang, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a distinct, non-overlapping purpose: product details, search, store availability, and store directory. No confusion between them.
All tools follow the consistent pattern 'hd_<noun>', with clear and predictable names that describe their function.
Four tools is well-scoped for a retail product information and store location service. Each tool is necessary and sufficient for typical queries.
The tool set covers core operations: search, product details, store list, and availability per store. No obvious gaps for the intended use case.
Related MCP Connectors
The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.
Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol server for Wix AI tools
Related MCP Servers
- AlicenseCqualityDmaintenanceA Model Context Protocol server enabling product searches across e-commerce platforms, price history tracking, and product specification-based searches using natural language prompts.2106 PyPI19MIT
- AlicenseNot gradedqualityCmaintenanceControl your grocery cart with AI! This MCP server enables LLMs (like Claude) to search past orders, find products, and manage your shopping cart across all Loblaws-owned grocery banners.12AGPL 3.0
- AlicenseAqualityFmaintenanceA Model Context Protocol (MCP) server for the Mouser Electronics API. Enables searching electronic components, managing shopping carts, and tracking orders directly through Claude or other MCP clients.95MIT
- AlicenseAqualityCmaintenanceAn MCP server that exposes SF Supplies product search API to LLM tools. Supports free-text search, autocomplete suggestions, and retrieving filterable attributes.3MIT