Skip to content

markswendsen-code/mcp-target

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

@striderlabs/mcp-target

MCP (Model Context Protocol) server connector for Target retail shopping. Enables AI assistants to search products, manage carts, and track orders on Target.com via browser automation.

Installation

npx @striderlabs/mcp-target

Or install globally:

npm install -g @striderlabs/mcp-target

MCP Configuration

Add to your MCP client config (e.g., Claude Desktop claude_desktop_config.json):

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

Tools

status

Check Target authentication status and session info.

Parameters: none


login

Authenticate with your Target account via browser automation.

Parameters:

Name Type Required Description
email string Target account email
password string Target account password
headless boolean Run browser headlessly (default: true). Set false to see the browser window.

Credentials are never stored — only session cookies are persisted to ~/.striderlabs/target/.


logout

Clear session cookies and log out.

Parameters: none


search_products

Search Target products with optional filters and sorting.

Parameters:

Name Type Required Description
query string Search term
category string Category filter (e.g., electronics)
min_price number Minimum price filter
max_price number Maximum price filter
sort_by string Sort order: relevance, price_low, price_high, newest, bestselling
limit number Max results (default: 10, max: 24)

get_product

Get detailed product information including price, description, and availability.

Parameters:

Name Type Required Description
url string Full Target product URL
tcin string Target product TCIN/item ID

Provide either url or tcin.


check_store_availability

Check if a product is available for in-store pickup at nearby Target stores.

Parameters:

Name Type Required Description
tcin string Target product TCIN
url string Product URL
zip_code string ZIP code for nearby store search

Provide either url or tcin.


add_to_cart

Add a product to your Target cart.

Parameters:

Name Type Required Description
url string Target product URL
tcin string Target product TCIN
quantity number Quantity (default: 1)
fulfillment string pickup, shipping, or delivery (default: shipping)

Requires login.


view_cart

View current cart contents and totals.

Parameters: none Requires login.


clear_cart

Remove all items from cart.

Parameters: none Requires login.


checkout

Preview or place a Target order.

Parameters:

Name Type Required Description
confirm boolean Set true to place the order. Default false (preview only).

Requires login. Always preview first before confirming.


get_orders

Get order history.

Parameters:

Name Type Required Description
limit number Number of recent orders (default: 10)

Requires login.


track_order

Track an order's status and delivery information.

Parameters:

Name Type Required Description
order_id string Target order ID

Requires login.


Session Storage

Session cookies are stored at ~/.striderlabs/target/:

  • cookies.json — Browser session cookies
  • auth.json — Account metadata (email, login timestamp)

Credentials (email/password) are never persisted.

Technical Details

  • Transport: stdio (MCP standard)
  • Browser automation: Playwright with Chromium + stealth patches
  • Stealth: Patches navigator.webdriver, plugins, permissions, and other bot-detection vectors
  • Cookie persistence: Survives across sessions; no repeated logins needed

Notes

  • Target.com may prompt for CAPTCHA or additional verification on first login. Use headless: false to handle these interactively.
  • Store availability and cart operations require geolocation; defaults to Chicago, IL.
  • The checkout tool with confirm: true will place a real order. Always preview first.

License

MIT — Strider Labs

About

MCP server connector for Target retail shopping

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors