@striderlabs/mcp-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