Skip to main content
Glama
mcp-homedepot

mcp-homedepot

by sstepanovvl

mcp-homedepot

License: PolyForm Noncommercial 1.0.0 Node

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

hd_search

Product search / listings by keyword. Returns products (SKU, name, brand, model, price, rating, online stock, URL, image), total count, facets and sort options.

hd_product

Full product card by SKU: name, brand, model, description, images, rating/reviews, warranty, categories, price, in-store stock + aisle/bay, online stock, fulfillment options.

hd_store_availability

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.

hd_stores

Store directory / find stores near a postal code (geocoded → distance-sorted with distanceKm), or the full national directory (~183 stores).

More tools (suggestions, categories) are planned.

Param

Type

Default

Notes

query

string

—

Search keyword (required).

storeId

string

9999

Store id for store-specific stock/pricing.

lang

en | fr

en

Response language.

sort

relevance | price-asc | price-desc | reviewAvgRating

relevance

Sort order.

page

int

0

0-indexed page.

pageSize

int (1–60)

24

Results per page.

hd_product

Param

Type

Default

Notes

sku

string

—

Product SKU / code (required), e.g. 1001686659.

postalCode

string

—

Postal code, e.g. M5V 2T6; uses the nearest store (overrides storeId).

storeId

string

7074

Store id for store-specific price/stock/aisle. Override default with HD_DEFAULT_STORE.

lang

en | fr

en

Response language.

hd_store_availability

Param

Type

Default

Notes

sku

string

—

Product SKU / code (required).

postalCode

string

—

Postal code; nearby stores are taken around it (overrides storeId).

storeId

string

7074

Reference store; nearby stores are taken from it.

lang

en | fr

en

Response language.

limit

int (1–20)

10

Max number of stores to check.

Default store: product/availability tools default to store 7074 (Langford, BC). Set HD_DEFAULT_STORE env var, or pass storeId, to use your local store. Use hd_stores with a postal code to find the right store id.

hd_stores

Param

Type

Default

Notes

postalCode

string

—

Canadian postal code, e.g. M5V 2T6. Returns nearest stores with distanceKm.

latitude / longitude

number

—

Alternative to postalCode for proximity.

lang

en | fr

en

Response language.

limit

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). distanceKm is 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 stdio

Quick 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 inspect

Connecting 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 tools
hd_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_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

    A4.3/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a distinct, non-overlapping purpose: product details, search, store availability, and store directory. No confusion between them.

    Naming Consistency5/5

    All tools follow the consistent pattern 'hd_<noun>', with clear and predictable names that describe their function.

    Tool Count5/5

    Four tools is well-scoped for a retail product information and store location service. Each tool is necessary and sufficient for typical queries.

    Completeness5/5

    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

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      A Model Context Protocol server enabling product searches across e-commerce platforms, price history tracking, and product specification-based searches using natural language prompts.
      2
      106 PyPI
      19
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Control 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.
      12
      AGPL 3.0
    • A
      license
      A
      quality
      F
      maintenance
      A 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.
      9
      5
      MIT