@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-etsyPlaywright browsers must be installed:
npx playwright install chromiumUsage 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: truefor safety. Setdry_run: falseto complete purchases.
Requirements
- Node.js >= 18
- Playwright (with Chromium browser)
License
MIT
