How do I use mcp-homedepot?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. 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

by sstepanovvl

Overview Schema Related Servers Score Discussions

TypeScript

Remote

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.

`hd_search`

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: MCP Tools

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.

Install Server

license - not found

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

BigGo MCP Server
E-commerce & Retail Search Data Platforms
Funmula-Corp
A
license
C
quality
C
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.
Last updated 2025-04-30
2
19
MIT
MCP Tools
Shell Access File Systems
ZbigniewTomanek
A
license
-
quality
D
maintenance
A custom Model Context Protocol server that gives Claude Desktop and other LLMs access to file system operations and command execution capabilities through standardized tool interfaces.
Last updated 2025-04-16
23
Apache 2.0
FireBall1725/pcexpress-mcp
E-commerce & Retail Search
FireBall1725
A
license
-
quality
A
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.
Last updated 2026-07-26
6
AGPL 3.0
Mouser Electronics MCP Server
E-commerce & Retail Search
nickweedon
A
license
-
quality
D
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.
Last updated 2025-12-25
5
MIT

View all related MCP servers

Related MCP Connectors

DataDoe MCP
Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.
hithereiamaliff-mcp-nextcloud
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
mcp
A Model Context Protocol server for Wix AI tools

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/sstepanovvl/mcp_homedepot'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

mcp-homedepot

Tools

hd_search

hd_product

hd_store_availability

hd_stores

How it talks to Home Depot

Build & run

Connecting a client

Project layout

License

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

BigGo MCP Server

MCP Tools

FireBall1725/pcexpress-mcp

Mouser Electronics MCP Server

Related MCP Connectors

Latest Blog Posts

MCP directory API

`hd_search`

`hd_product`

`hd_store_availability`

`hd_stores`