Ecommerce

Etsy MCP Server

Connect your account, then chat with AI to run tools.

Manage shop listings, read orders, and pull shipping policies from chat — connect your Etsy shop once in MCPBundles and let an AI agent handle Seller Dashboard navigation.

Best forEtsy SellersHandmade MakersVintage ResellersShop Managers

Try this workflow

Shop overview

Read my Etsy shop profile and summarize active listing count, currency, and recent order volume from the stats rollup.

Managed
23 tools
Agent guide included

Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.

Browse all tools

What you can do with Etsy

Built for

Etsy Sellers, Handmade Makers, Vintage Resellers, Shop Managers

Example workflows

Shop overview

Shop and stats reads for a quick health check.

Try this

Read my Etsy shop profile and summarize active listing count, currency, and recent order volume from the stats rollup.

Draft listing prep

Policy and taxonomy reads before listing writes.

Try this

List my Etsy shipping profiles and return policies, then show seller taxonomy nodes for jewelry so I can pick a category for a new draft.

Order fulfillment

Receipt list for fulfillment workflows.

Try this

List open Etsy receipts from the last seven days, show buyer shipping addresses, and flag any without tracking.

Listing inventory

Listing and inventory reads for restock planning.

Try this

List my active Etsy listings with titles and prices, then fetch inventory quantities for the three lowest-stock items.

Context to know first

What is Etsy MCP?

It connects your Etsy shop to AI assistants for reading listings, orders, reviews, shipping policies, and shop stats — and for listing writes when your workflow requires them.

Who is this for?

Etsy sellers who want listing, order, and policy context from chat instead of clicking through Shop Manager.

Can an agent publish or delete listings?

Yes, when your workflow calls for it — create and update draft listings, adjust inventory, and delete listings only with confirm_write on destructive actions.

AI Skill
SKILL.md

Domain knowledge for Etsy — workflow patterns, data models, and gotchas for your AI agent.

Etsy

Etsy sellers manage a shop with listings, receipts (orders), transactions, and reviews.

First moves

  1. Shop — read the shop for the connected user to get shop_id, currency, and policies.
  2. Listings — list active listings, then fetch one listing or its inventory when SKU counts matter.
  3. Keyword search — search marketplace active listings when researching comps outside your shop.
  4. Shop sections — read section ids/names for organizing listings in the storefront.
  5. Shipping and return policies — list shop shipping profiles and return policies before drafting listings.
  6. Seller taxonomy — browse Etsy category nodes when mapping listing taxonomy.
  7. Shop stats — composite rollup from shop profile plus recent receipts sample.
  8. Orders — list receipts for the shop; open one receipt for buyer and shipment details.
  9. Reviews — pull shop reviews for reputation questions.

Data model

User → Shop → Listings / Receipts / Reviews. Receipts contain transactions (line items). Listing inventory holds quantity per offering.

Operational order

  1. Resolve shop_id once per session (from shop read for the authenticated seller).
  2. List receipts with min/max created timestamps when the user names a date window.
  3. Use keyword search for market-wide discovery; shop listing reads only cover your inventory.
  4. Drill into listing or receipt ids returned by list responses — do not guess ids.

Writes

Draft listings need taxonomy_id, shipping_profile_id, and return policy ids from the shop policy reads. Upload listing images before activating. Mark receipts shipped with tracking when fulfillment completes. Listing delete is permanent — expect confirm_write on destructive actions.

Gotchas

  • Receipts vs orders — Etsy names completed checkouts receipts; order language in chat maps to receipt ids.
  • Pagination — listing and receipt lists return at most 100 rows per page; keep paging by advancing offset until done.
  • Rate limits — Etsy enforces per-app quotas; prefer filtered receipt lists over repeated full scans.
  • Policy ids before drafts — new listings need shipping profile, return policy, and taxonomy ids from shop reads first.

Tools in this Server (23)

Etsy Create Draft Listing

Create a draft Etsy listing in a shop. Requires quantity, title, description, price, who_made, when_made, taxonomy_id, and shipping profile. Processin...

Etsy Create Receipt Shipment

Add shipment tracking to an Etsy receipt and optionally notify the buyer. Requires tracking_code and carrier_name.

Etsy Delete Listing

Delete an Etsy listing permanently. Requires confirm_write=true and listings_d scope.

Etsy Find Shops

Search public Etsy shops by name. Returns shop ids and titles for discovery when the user names a storefront.

Etsy Get Listing

Fetch one listing by listing id with description, price, tags, and materials.

Etsy Get Listing Inventory

Fetch inventory offerings and quantities for a listing.

Etsy Get Listings

List active listings for a shop with pagination. Returns listing ids, titles, prices, and state.

Etsy Get Me

Read the authenticated Etsy user profile including user id and shop id when present.

Etsy Get Receipt

Fetch one shop receipt (order) by receipt id.

Etsy Get Receipts

List shop receipts (orders) with optional min_created and max_created unix timestamps.

Etsy Get Reviews

List buyer reviews for the shop.

Etsy Get Seller Taxonomy

Return the Etsy seller taxonomy node tree used for listing category assignment.

Etsy Get Shop

Fetch one Etsy shop by shop_id — title, currency, policies, and listing counts.

Etsy Get Shop Return Policies

List Etsy shop return policies. Returns return policy ids and windows — required alongside shipping profiles when drafting new listings.

Etsy Get Shop Sections

List Etsy shop sections (id, title, rank) for a shop.

Etsy Get Shop Shipping Profiles

List Etsy shop shipping profiles for a shop. Returns profile ids, titles, processing days, and origin country — required before creating draft listing...

Etsy Get Shop Stats

Read-only composite rollup from shop profile plus a sample of recent receipts (counts and grand-total sum in the sample window).

Etsy Get Transactions

List shop transactions (line items) with pagination.

Etsy Search Listings

Search active Etsy marketplace listings by keywords with optional sort, price filters, and pagination.

Etsy Update Listing

Update an Etsy listing by listing_id. Pass only fields to change — title, description, price, quantity, tags, state, or shipping profile.

Etsy Update Listing Inventory

Replace Etsy listing inventory offerings (SKU, property values, price, quantity). Pass the full products payload for the listing.

Etsy Update Receipt

Update an Etsy shop receipt — mark paid/shipped or attach tracking. To add carrier tracking with buyer notification, use the dedicated shipment create...

Etsy Upload Listing Image

Upload an image to an Etsy shop listing. Returns listing_image_id and rank. Images must meet Etsy size guidelines. Provide exactly one of: file_conten...

Frequently Asked Questions

What is Etsy MCP?

It connects your Etsy shop to AI assistants for reading listings, orders, reviews, shipping policies, and shop stats — and for listing writes when your workflow requires them.

Who is this for?

Etsy sellers who want listing, order, and policy context from chat instead of clicking through Shop Manager.

Can an agent publish or delete listings?

Yes, when your workflow calls for it — create and update draft listings, adjust inventory, and delete listings only with confirm_write on destructive actions.

How do I connect?

Open the Etsy skill page in MCPBundles, paste your developer app keystring and shared secret, and complete OAuth with listing and shop scopes.

How do I connect Etsy to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/etsy. Authentication is handled automatically.

How many tools does Etsy provide?

Etsy provides 23 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does Etsy require?

Etsy uses One-click sign in. Etsy requires credentials. Connect via MCPBundles and authentication is handled automatically.

Setup Instructions

Connect Etsy to any MCP client in minutes

MCP URL
https://mcp.mcpbundles.com/bundle/etsy

One-click install:

The link prefills the Add custom connector dialog — you still review the values and click Add, then Connect to complete OAuth.

Or add manually

  1. Open claude.ai → Settings → Connectors.
  2. Click the + button and choose Add custom connector.
  3. Set Name to Etsy and paste the MCP URL into Remote MCP server URL.
  4. Click Add. Etsy will appear under Not connected — select it and click Connect to complete OAuth.
Name: Etsy
Remote MCP server URL: https://mcp.mcpbundles.com/bundle/etsy
Authentication: OAuth

Custom connectors at claude.ai require a paid Claude plan (Pro, Max, Team, or Enterprise).

Ready to use Etsy?

Sign in to connect your credentials and start running tools from the chat.

Etsy Seller MCP Server