Skip the install. Get this working in under 2 minutes.
Start a free trial on cloud.anythingmcp.com, add the Etsy in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.
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.
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.
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 + Gemini
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
You authorize it once, in AnythingMCP; from then on the short-lived access token (1 hour) is renewed automatically, and the refresh token Etsy replaces on every renewal is stored for you.
Setup:
- Register an app at https://www.etsy.com/developers/your-apps → Create New App.
- In the app's settings, add this callback URL:
https://cloud.anythingmcp.com/api/mcp-oauth/callbackon AnythingMCP Cloud, or<your AnythingMCP server URL>/api/mcp-oauth/callbackwhen you host AnythingMCP yourself. Etsy compares it character for character (https, upper/lower case, no trailing slash).
…(continued in the in-app connector instructions)
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 Gemini
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 showsYOUR_SERVER_ID.
Gemini CLI reads MCP servers from ~/.gemini/settings.json (or %APPDATA%\gemini\settings.json on Windows). Add:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Get your MCP API key from AnythingMCP → MCP Servers → your server → API keys.
- Save the file and restart
gemini. - Run
/mcpinside the Gemini CLI —Etsyshould be listed as available. - Vertex AI Studio: pass
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDto thetoolsarray of your request with the sameX-API-Keyheader.
Available tools
| Tool | What it does |
|---|---|
etsy_get_authenticated_user | Return the user the OAuth token belongs to |
etsy_get_user_shops | List shops owned by the user |
etsy_get_shop | Fetch one shop by shop_id with full details (announcement, sale message, etc.) |
etsy_get_shop_listings_active | List active listings in a shop |
etsy_get_listing | Fetch one listing by listing_id with full details |
etsy_get_shop_receipts | List orders (receipts) for the shop |
etsy_get_shop_receipt | Fetch one receipt with buyer info, transactions[], shipping address |
etsy_get_shop_reviews | List reviews (transactions with feedback) for the shop |
etsy_get_listings_by_shop_section | List listings filtered by a shop section |
etsy_get_listings_by_shop | Listings of your own shop by state (active, inactive, sold_out, draft, removed, expired), as the shop owner sees them |
etsy_list_seller_taxonomy | The full tree of Etsy seller categories (id, name, children) |
etsy_list_taxonomy_properties | Properties (size, colour, material…) and their allowed values for one seller category |
etsy_list_shipping_profiles | The shop's shipping profiles |
etsy_list_processing_profiles | The shop's processing profiles (Etsy calls them readiness states: ready to ship or made to order, with processing times) |
etsy_list_return_policies | The shop's return policies |
etsy_list_shop_sections | The shop's sections, to file a listing under one with shop_section_id |
etsy_read_listing_inventory | Products, prices, quantities and SKUs of a listing, per variation |
etsy_create_listing_draft | Create a listing as a draft (not visible to buyers) |
etsy_edit_listing | Change a listing: title, description, tags, category, shipping, section, or state. state=active publishes a draft (it needs at least one… |
etsy_set_listing_inventory | Set price, quantity and SKU of a listing, per variation |
etsy_add_listing_image | Add 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_tracking | Mark an order (receipt) as shipped with its tracking code |
FAQ
Does Gemini 1.5 Pro or 2.x support MCP? Yes — Gemini CLI ≥ 0.4 and Vertex AI tools API both accept MCP httpUrl connectors with custom headers.
Next steps
Was this guide helpful?