@striderlabs/mcp-aldi

MCP (Model Context Protocol) connector for Aldi grocery. Provides tools for searching products, finding stores, browsing weekly specials, and more.

Installation

npm install @striderlabs/mcp-aldi

Usage

With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "aldi": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-aldi"]
    }
  }
}

Run directly

npx @striderlabs/mcp-aldi

Available Tools

search_products

Search the Aldi product catalog by keyword or category.

Parameters:

• query (required) — search term (e.g. "organic milk", "pasta")
• category (optional) — filter by category: dairy, produce, bakery, frozen, meat, snacks, beverages, dry-goods, breakfast
• limit (optional) — max results (default 10, max 50)

find_stores

Find Aldi store locations near an address, city, or zip code.

Parameters:

• location (required) — address, city, or zip code
• radius_miles (optional) — search radius in miles (default 10, max 50)
• limit (optional) — max stores to return (default 5, max 20)

get_weekly_specials

Get current weekly deals and ALDI Finds.

Parameters:

• store_id (optional) — store-specific specials
• category (optional) — filter by category (e.g. produce, meat, aldi-finds)

get_product_details

Get detailed product info including nutrition facts, ingredients, and price.

Parameters:

• product_id (required) — product ID from search_products

get_store_hours

Get hours and contact info for a specific store.

Parameters:

• store_id (required) — store ID from find_stores

check_product_availability

Check if a product is available at a specific store.

Parameters:

• product_id (required)
• store_id (required)

Development

# Install dependencies
npm install

# Build
npm run build

# Run dev (requires tsx)
npm run dev

License

MIT