etsy-mcp-server
Provides tools for managing an Etsy shop, including listings, inventory, images, digital files, orders, and taxonomy through the Etsy Open API v3.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@etsy-mcp-serverlist my active listings"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
etsy-mcp-server
Full-featured Model Context Protocol server for the Etsy Open API v3. Manage your Etsy shop — listings, inventory, images, digital files, orders — entirely through Claude or any MCP-compatible client.
Features
Group | Tools |
Shop |
|
Listings |
|
Images |
|
Digital files |
|
Inventory |
|
Sections |
|
Taxonomy |
|
Orders |
|
Related MCP server: Etsy MCP Server
Prerequisites
Node.js 18+
An Etsy Developer account with an app created
Your app must be approved for OAuth write access (Etsy reviews new apps)
Installation
git clone https://github.com/DColl/etsy-mcp-server.git
cd etsy-mcp-server
npm install
cp .env.example .envEdit .env and fill in your credentials:
ETSY_API_KEY=your_keystring_here
ETSY_API_SECRET=your_shared_secret_hereAuthentication
Step 1 — OAuth authorization (required for write operations)
npm run authThis opens a local browser flow. After authorizing, tokens are saved to .env automatically.
Step 2 — Find your Shop ID
Build the server and ask Claude: "call get_me" — it returns your shop_id. Add it to .env:
ETSY_SHOP_ID=12345678Build & run
npm run build
npm startOr in dev mode (no build step):
npm run devConfigure Claude Code
Add to your Claude Code settings (~/.claude/settings.json or project .claude/settings.json):
{
"mcpServers": {
"etsy": {
"command": "node",
"args": ["/absolute/path/to/etsy-mcp-server/dist/index.js"],
"env": {
"ETSY_API_KEY": "your_keystring",
"ETSY_API_SECRET": "your_shared_secret",
"ETSY_ACCESS_TOKEN": "your_access_token",
"ETSY_REFRESH_TOKEN": "your_refresh_token",
"ETSY_TOKEN_EXPIRY": "your_token_expiry",
"ETSY_SHOP_ID": "your_shop_id"
}
}
}
}Configure Claude Desktop
Add to ~/AppData/Roaming/Claude/claude_desktop_config.json (Windows):
{
"mcpServers": {
"etsy": {
"command": "node",
"args": ["C:\\path\\to\\etsy-mcp-server\\dist\\index.js"]
}
}
}Example usage with Claude
Create a draft listing for my PDF printable "STOP Before You Pay" fraud prevention checklist.
Price: $4.99, it's a digital download, quantity 999.
Use suggest_tags with keyword "printable" to find the right taxonomy, then add tags.
Upload cover.jpg as image and stop-before-you-pay.pdf as the digital file.
Then publish the listing.Rate limits
Etsy allows 5 requests/second and 5,000 requests/day per API key.
License
MIT — © TBS-Digital 2026
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/DColl/etsy-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server