# Etsy Seller MCP Hub

> Etsy Seller MCP Hub is an open-source MCP server for e-commerce. Self-hosted MCP server and CLI to manage your own Etsy shop's listings and orders. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/bl0ck154/etsy-seller-mcp-hub
- **MCP Registry name:** io.github.Bl0ck154/etsy-seller-mcp-hub
- **Categories:** [e-commerce](https://ai-powered.com/categories/e-commerce)
- **Listing updated:** 2026-11-15

## About

Aimed at sellers rather than shoppers, this toolkit sits on top of Etsy's Open API v3 and exposes 79 tools. The same actions are available through an etsyctl command-line tool and a local HTTP gateway, which suits scripts and GPT Actions. It does not watch consumer prices or hunt for buyer deals.

It starts cautious. Setting ETSY_MCP_READ_ONLY=1 limits the server to 53 read-only tools, and the README recommends this for first use. Typed writes to listings, inventory and media create backups where supported, but raw API writes have no automatic snapshots. Two seller reports run read-only: a bounded low-stock scan and an unshipped-orders summary that leaves out buyer contact details.

You need Node.js 22 or newer, an approved Etsy Open API v3 app and OAuth authorization for your own shop; the hub handles PKCE, refresh, retries and rate limits and checks shop ownership afterwards. The local HTTP service binds to 127.0.0.1. The author does not run a shared server holding other sellers' tokens, and multi-tenant use is not implemented. The README says it is not endorsed by Etsy.

## Features

- **79 seller tools:** Covers listings, inventory, orders, shipping settings, personalization and media.
- **Read-only mode:** ETSY_MCP_READ_ONLY=1 exposes only 53 tools annotated read-only.
- **Seller reports:** etsy_report_low_stock and etsy_report_unshipped give read-only summaries.
- **CLI and HTTP gateway:** etsyctl and a local HTTP API run the same workflows outside an AI client.
- **OAuth handling:** Supports PKCE, token refresh, retries and rate limits, and verifies shop ownership.
- **Backups on writes:** Typed listing, inventory and media writes create backups where supported.
- **Docker option:** A non-root Dockerfile is provided for running it in a container.

## Good for

- Find active listings that are low on stock
- List paid but unshipped orders without buyer contact data
- Review personalization options on a listing
- Prepare listing changes for approval before applying them
- Upload product images or videos to a listing

## Install

### Claude Code (Terminal)

```sh
claude mcp add etsy-seller-mcp-hub --env ETSY_HUB_CONFIG='<ETSY_HUB_CONFIG>' -- npx -y etsy-seller-mcp-hub
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "etsy-seller-mcp-hub": {
      "command": "npx",
      "args": [
        "-y",
        "etsy-seller-mcp-hub"
      ],
      "env": {
        "ETSY_HUB_CONFIG": "<ETSY_HUB_CONFIG>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "etsy-seller-mcp-hub": {
      "command": "npx",
      "args": [
        "-y",
        "etsy-seller-mcp-hub"
      ],
      "env": {
        "ETSY_HUB_CONFIG": "<ETSY_HUB_CONFIG>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "etsy-seller-mcp-hub": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "etsy-seller-mcp-hub"
      ],
      "env": {
        "ETSY_HUB_CONFIG": "<ETSY_HUB_CONFIG>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "etsy-seller-mcp-hub": {
      "command": "npx",
      "args": [
        "-y",
        "etsy-seller-mcp-hub"
      ],
      "env": {
        "ETSY_HUB_CONFIG": "<ETSY_HUB_CONFIG>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "etsy-seller-mcp-hub": {
      "command": "npx",
      "args": [
        "-y",
        "etsy-seller-mcp-hub"
      ],
      "env": {
        "ETSY_HUB_CONFIG": "<ETSY_HUB_CONFIG>"
      }
    }
  }
}
```

## Tools

- `etsy_report_low_stock`: Bounded read-only inventory scan for low stock.
- `etsy_report_unshipped`: Read-only summary of paid but unshipped orders with minimised customer data.

## FAQ

### Can I use it without write access?

Yes. Set ETSY_MCP_READ_ONLY=1 to limit the server to 53 read-only tools.

### Does it work with an existing Etsy API key?

Yes, if it is an approved Etsy Open API v3 key and you have the required OAuth authorization.

### Is there a hosted version?

No. It is self-hosted and the author does not operate a shared server for other sellers' tokens.

### What does it require?

Node.js 22 or newer, an approved Etsy app and OAuth for your own shop.

### Are raw API writes backed up?

No. Typed writes create backups where supported, but raw API writes have no automatic snapshots.

### Is Etsy Seller MCP Hub free?

Yes. Etsy Seller MCP Hub is open source, so you can use and self-host it for free.

### How do I add Etsy Seller MCP Hub to Claude Code?

Run this command in your terminal: claude mcp add etsy-seller-mcp-hub --env ETSY_HUB_CONFIG='<ETSY_HUB_CONFIG>' -- npx -y etsy-seller-mcp-hub

### What are the best alternatives to Etsy Seller MCP Hub?

The closest alternatives to Etsy Seller MCP Hub are eBay Seller Tools, cob-shopify-mcp, Etsy Tags MCP, Etsy Search & Shop Sales MCP and Growtsy — free Etsy seller tools.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [eBay Seller Tools](https://ai-powered.com/mcp/ebay-seller-tools): eBay Seller Tools is an open-source MCP server for e-commerce.
- [cob-shopify-mcp](https://ai-powered.com/mcp/cob-shopify-mcp): cob-shopify-mcp is an open-source MCP server for e-commerce.
- [Etsy Tags MCP](https://ai-powered.com/mcp/etsy-tags-mcp): Etsy Tags MCP is an open-source MCP server for marketing and seo.
- [Etsy Search & Shop Sales MCP](https://ai-powered.com/mcp/etsy-search-and-shop-sales-mcp): Etsy Search & Shop Sales MCP is a paid MCP server for sales and crm.
- [Growtsy — free Etsy seller tools](https://ai-powered.com/mcp/growtsy-free-etsy-seller-tools): Growtsy — free Etsy seller tools is a free MCP server for e-commerce.
- [Marginrule pricing agent](https://ai-powered.com/mcp/marginrule-pricing-agent): Marginrule pricing agent is a free MCP server for e-commerce.
- [Ecommerce Mcp](https://ai-powered.com/mcp/ecommerce-mcp): Ecommerce Mcp is a freemium MCP server for e-commerce.
- [Shopify MCP Server (any store)](https://ai-powered.com/mcp/shopify-mcp-server-any-store): Shopify MCP Server (any store) is a paid MCP server for e-commerce.

---
Source: https://ai-powered.com/mcp/etsy-seller-mcp-hub
