Skip to content
MCP server

Etsy Seller MCP Hub

Self-hosted MCP server and CLI to manage your own Etsy shop's listings and orders

Runs locally
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.5.0
Listing updated
4 days ago

Similar MCP servers

About Etsy Seller MCP Hub

Etsy Seller MCP Hub is an open-source MCP server for e-commerce. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • ETSY_HUB_CONFIGAbsolute path to your local Etsy API Hub configuration file.Required
  • ETSY_MCP_READ_ONLYSet to 1 to limit the exposed MCP tools to read-only operations.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

MIT licence; Etsy API access terms apply

Etsy Seller MCP Hub 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.

How AIPoweredBot checks servers