Connector guide8-minute read42 MCP tools7 languages

How to Connect Etsy to Claude — via MCP

Run an Etsy shop from any AI agent: create draft listings, edit and publish them, add photos, set price and stock, add tracking to orders, and read listings, orders, receipts and reviews. OAuth2 with automatic refresh-token rotation + x-api-key dual auth.

HCBy HelpCode teamUpdated 8 min read Open-source on GitHub

No credit card · 7-day trial · Self-host alternative available

Etsy

Etsy

Run an Etsy shop from any AI agent: create draft listings, edit and publish them, add photos, videos and digital files, set price, stock, attributes and translations, add tracking to orders, and read listings, orders, receipts and reviews. OAuth2 with automatic refresh-token rotation + x-api-key dual auth.

tools

42

Region

INTL

Category

E-commerce

Authentication

OAuth 2.0

Required env vars

ETSY_CLIENT_IDETSY_CLIENT_SECRET
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Open source · AGPL-3.0
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

Summary

Run an Etsy shop from any AI agent: create draft listings, edit and publish them, add photos, set price and stock, add tracking to orders, and read listings, orders, receipts and reviews. OAuth2 with automatic refresh-token rotation + x-api-key dual auth.

Guided setup

Connect Etsy to Claude in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Etsy in the guided setup, then add your MCP URL to Claude. No code and no server to run.

No credit card · 7-day trial · Self-host alternative available

AnythingMCP is listed in Claude's connector directory: add it to Claude in one click (opens in a new tab), then sign in and choose which MCP servers Claude may use.

Try asking

Example prompts for Etsy

Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.

Etsy · live via MCP
Share
Opus 4.7

Claude is AI and can make mistakes. Please double-check responses.

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Etsy, paste your credentials, mint an MCP API key — done. No Docker, no git clone, no local server.

Etsy + Claude

Run an Etsy shop from any AI agent: create draft listings, edit and publish them, add photos, set price and stock, add tracking to orders, and read listings, orders, receipts and reviews. OAuth2 with automatic refresh-token rotation + x-api-key dual auth.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

ETSY_CLIENT_ID, ETSY_CLIENT_SECRET

Step 1 — Get credentials

Etsy reviews every new app before it can be used, usually within a day. You can start right away: AnythingMCP keeps your keys while you wait. On AnythingMCP Cloud the Etsy setup page walks you through these steps and tells you when Etsy has approved your app.

  1. Create your Etsy app. Open Etsy's app form, sign in with the account that owns your shop and create a personal app. Etsy lists it under Personal Apps with the status Pending Personal Approval: that is normal.
  2. Copy your two keys. From the same row under Personal Apps on your Etsy apps page, copy the Keystring and the Shared Secret into AnythingMCP and save. This works while the app is still pending.
  3. Wait for Etsy's approval. Etsy emails you when the app is approved; most are approved within a day. Until then, clicking the app's name does nothing.
  4. Add the callback URL. Once the app is active, click its name to open its page and add https://cloud.anythingmcp.com/api/mcp-oauth/callback under Callback URLs (self-hosted: <your AnythingMCP server URL>/api/mcp-oauth/callback). Etsy compares it character for character.
  5. Sign in with Etsy. Click Authorize with Provider (on the setup page: Sign in with Etsy) and approve with the account that owns the shop. The tools are ready as soon as you are back. Etsy also asks you to allow deleting listings (listings_d), which only the switched-off delete tools use.

Listing details, media and search: the AI can also read and set a listing's attributes (colour, material, size), add or replace its translations (title, description, tags), list its photos and link them to variation values, add a listing video, upload the files buyers download from a digital listing, list your production partners, and search all active listings and shops on Etsy. Three tools install switched off because they delete for good: etsy_delete_listing_permanently (to hide a listing instead, set it inactive), etsy_delete_listing_image and etsy_delete_listing_property. Switch them on deliberately on the connector page when you need them; the AI asks before every change.

Already installed? The new tools reach a connector you installed earlier through its catalog update: open the connector in AnythingMCP and, under Catalog update available, check the list of new tools and click Apply update. Your credentials and any tools you added yourself stay as they are, and the delete tools arrive switched off, as on a new install. Before you use them, click Authorize with Provider again so that Etsy grants listings_d; until then Etsy answers "Access token lacks scope".

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in Claude

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Recommended path — works on claude.ai web without editing any config file.

  1. In Claude, open Customize → Connectors.
  2. Click +, then Add custom connector.
  3. Enter a name, e.g. Etsy, and the remote MCP server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, then click Add.
  4. Click Connect and sign in to AnythingMCP (OAuth) to allow access.

All tools below appear in your chat — start typing prompts.

Available tools

ToolWhat it does
etsy_get_authenticated_userReturn the user the OAuth token belongs to
etsy_get_user_shopsList shops owned by the user
etsy_get_shopFetch one shop by shop_id with full details (announcement, sale message, etc.)
etsy_get_shop_listings_activeList active listings in a shop
etsy_get_listingFetch one listing by listing_id with full details
etsy_get_shop_receiptsList orders (receipts) for the shop
etsy_get_shop_receiptFetch one receipt with buyer info, transactions[], shipping address
etsy_get_shop_reviewsList reviews (transactions with feedback) for the shop
etsy_get_listings_by_shop_sectionList listings filtered by a shop section
etsy_get_listings_by_shopListings of your own shop by state (active, inactive, sold_out, draft, removed, expired), as the shop owner sees them
etsy_list_seller_taxonomyThe full tree of Etsy seller categories (id, name, children)
etsy_list_taxonomy_propertiesProperties (size, colour, material…) and their allowed values for one seller category
etsy_list_shipping_profilesThe shop's shipping profiles
etsy_list_processing_profilesThe shop's processing profiles (Etsy calls them readiness states: ready to ship or made to order, with processing times)
etsy_list_return_policiesThe shop's return policies
etsy_list_shop_sectionsThe shop's sections, to file a listing under one with shop_section_id
etsy_read_listing_inventoryProducts, prices, quantities and SKUs of a listing, per variation
etsy_create_listing_draftCreate a listing as a draft (not visible to buyers)
etsy_edit_listingChange a listing: title, description, tags, category, shipping, section, or state. state=active publishes a draft (it needs at least one…
etsy_set_listing_inventorySet price, quantity and SKU of a listing, per variation
etsy_add_listing_imageAdd a photo to a listing from a public image URL (JPG, PNG or GIF, up to 10 MB). rank 1 is the main photo
etsy_add_order_trackingMark an order (receipt) as shipped with its tracking code
etsy_get_listings_by_idsFetch up to 100 listings in one call by their listing ids, with the same details as etsy_get_listing (title, description, state, price…
etsy_get_shop_transactionsList the shop's sold items (transactions, one per listing line of an order): transaction_id, receipt_id, listing_id, title, sku, quantity…
etsy_get_listing_propertiesRead the attribute values set on a listing (colour, material, size, occasion, ...): one entry per property with property_id, property_name…
etsy_set_listing_propertySet one attribute of a listing (e.g. primary colour, material, occasion), replacing its current values. property_id, the allowed value_ids…
etsy_delete_listing_propertyRemove one attribute (property) and its values from a listing
etsy_read_listing_translationRead a listing's translation into one language: translated title, description and tags
etsy_add_listing_translationAdd a translation of a listing for buyers browsing Etsy in another language: title, description and optional tags in that language
etsy_replace_listing_translationReplace a listing's existing translation into one language: send the full translated title and description (and tags, which are cleared…
etsy_list_listing_imagesList the photos of a listing in display order: listing_image_id, rank, url_fullxfull and smaller sizes, dimensions, alt_text and the…
etsy_delete_listing_imageRemove a photo from a listing
etsy_list_listing_variation_imagesList which photo is shown for which variation value of a listing (e.g. the red mug photo for Colour = Red): entries with property_id…
etsy_assign_variation_imagesLink listing photos to variation values, so buyers see the right photo when they pick an option
etsy_list_listing_filesList the downloadable files of a digital listing: listing_file_id, filename, filesize, filetype, rank and creation time
etsy_upload_listing_fileAttach a file buyers download after purchase to a digital listing (type download or both), from a public URL
etsy_list_listing_videosList the videos of a listing: video_id, height, width, thumbnail_url, video_url and video_state (active or still processing)
etsy_add_listing_videoUpload an existing video file to a listing from a public URL
etsy_delete_listing_permanentlyDelete a listing for good, in any state (active, inactive, draft, expired, sold out)
etsy_search_active_listingsSearch all active listings on Etsy, not only your shop's, by keywords, category, price range or shop location: e.g. to see what similar…
etsy_search_shopsFind Etsy shops by name
etsy_list_production_partnersList the shop's production partners (people or companies who help make the items): production_partner_id, partner_name and location

FAQ

Does it work with Claude Code as well as Claude Desktop? Yes — point both at https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Next steps

Was this guide helpful?

Connect Etsy to Claude in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Etsy in the guided setup, then add your MCP URL to Claude. No code and no server to run.

Related guides

Connectors

Connect Etsy to Microsoft Copilot via MCP

Run an Etsy shop from any AI agent: create draft listings, edit and publish them, add photos, set price and stock, add tracking to orders, and read listings, orders, receipts and reviews. OAuth2 with automatic refresh-token rotation + x-api-key dual auth.

Connectors

Connect Etsy to Meta Muse via MCP: Listings and Orders

Run an Etsy shop from any AI agent: create draft listings, edit and publish them, add photos, set price and stock, add tracking to orders, and read listings, orders, receipts and reviews. OAuth2 with automatic refresh-token rotation + x-api-key dual auth.

Connectors

Connect Etsy to ChatGPT via MCP: Listings and Orders

Run an Etsy shop from any AI agent: create draft listings, edit and publish them, add photos, set price and stock, add tracking to orders, and read listings, orders, receipts and reviews. OAuth2 with automatic refresh-token rotation + x-api-key dual auth.

Connectors

Connect Etsy to Cursor via MCP: Listings and Orders

Run an Etsy shop from any AI agent: create draft listings, edit and publish them, add photos, set price and stock, add tracking to orders, and read listings, orders, receipts and reviews. OAuth2 with automatic refresh-token rotation + x-api-key dual auth.

Connectors

Connect Etsy to Gemini CLI via MCP: Listings and Orders

Run an Etsy shop from any AI agent: create draft listings, edit and publish them, add photos, set price and stock, add tracking to orders, and read listings, orders, receipts and reviews. OAuth2 with automatic refresh-token rotation + x-api-key dual auth.

Connectors

Etsy MCP Server: Listings, Orders and Reviews

Run an Etsy shop from any AI agent: create draft listings, edit and publish them, add photos, set price and stock, add tracking to orders, and read listings, orders, receipts and reviews. OAuth2 with automatic refresh-token rotation + x-api-key dual auth.