@Striderlabs/ Etsy

An MCP (Model Context Protocol) server connector for Etsy that enables AI agents to search, browse, and interact with Etsy using browser automation via Playwright.

Features

• Search Products - Search handmade, vintage, and supply items with filters
• View Item Details - Get detailed listing info including seller, reviews, and shipping
• Add to Cart - Add items with variations and quantity
• View Cart - Check current cart contents
• Manage Favorites - View and add items to favorites/collections
• Purchase Items - Proceed through checkout flow
• Track Orders - View order history and tracking status
• Message Sellers - Send messages to shop owners
• Shop Info - Browse seller profiles and listings

Installation

npm install -g @striderlabs/mcp-etsy

Playwright browsers must be installed:

npx playwright install chromium

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "etsy": {
      "command": "mcp-etsy"
    }
  }
}

Available Tools

Tool	Description
etsy_search_products	Search Etsy with filters (category, price, sort)
etsy_get_item_details	Get full listing details
etsy_add_to_cart	Add item to cart
etsy_view_cart	View cart contents
etsy_get_favorites	View favorited items
etsy_add_to_favorites	Add item to favorites
etsy_checkout	Proceed through checkout
etsy_track_orders	View and track orders
etsy_message_seller	Contact a seller
etsy_login	Log in to Etsy account
etsy_get_shop_info	Browse a seller's shop
etsy_close_browser	Clean up browser resources

Authentication

For actions requiring login (cart, favorites, orders, messaging), use etsy_login first:

Use etsy_login with my email and password, then search for handmade jewelry under $50.

Note: Some operations like checkout default to dry_run: true for safety. Set dry_run: false to complete purchases.

Requirements

• Node.js >= 18
• Playwright (with Chromium browser)

License

MIT