Connector guide2-minute read9 MCP toolsEnglish · Deutsch · Italiano

Come collegare Etsy a Gemini — via MCP

Read Etsy shop data (listings, transactions, receipts, reviews) from any AI agent. 9 tools, OAuth2 + x-api-key dual auth.

HCBy HelpCode teamUpdated 2 min read Open source on GitHub

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

Etsy

MCP connector

Etsy

Read Etsy shop data (listings, transactions, receipts, reviews) from any AI agent. 9 tools, OAuth2 + x-api-key dual auth.

Tools

9

Region

INTL

Category

e-commerce

Authentication

API Key

Required env vars

ETSY_API_KEYETSY_ACCESS_TOKEN
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
    Source-available BSL-1.1
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

No install? Use cloud.anythingmcp.com directly.

Sign in, install the Etsy in one click, paste the credentials, mint an MCP API key — done. No Docker, no git clone, no local server to run.

Open Cloud

TL;DR

Read Etsy shop data (listings, transactions, receipts, reviews) from any AI agent. 9 tools, OAuth2 + x-api-key dual auth.

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Etsy, inserisci le credenziali, genera una MCP API key — fatto. Niente Docker, niente git clone, niente server locale.

Etsy + Gemini

Read Etsy shop data (listings, transactions, receipts, reviews) from any AI agent. 9 tools, OAuth2 + x-api-key dual auth.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

ETSY_API_KEY, ETSY_ACCESS_TOKEN

Step 1 — Ottieni le credenziali

etsy.com).

Setup:

  1. Register an app at https://www.etsy.com/developers/your-appsCreate New App.
  2. Note the Keystring (this is your x-api-key) and Shared secret.
  3. Run OAuth2 PKCE flow with scopes transactions_r listings_r email_r shops_r (or write-scopes if needed).
  4. Get the access token (1 hour expiry) + refresh token (long-lived).
  5. Set:
    • ETSY_API_KEY = the Keystring (a.k.a. x-api-key)
    • ETSY_ACCESS_TOKEN = the OAuth2 access token

…(continued in the in-app connector instructions)

Step 2 — Installa l'adapter

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d

Step 3 — Aggiungi il connettore in Gemini

Gemini CLI legge i server MCP da ~/.gemini/settings.json (o %APPDATA%\gemini\settings.json su Windows). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_API_KEY" }
    }
  }
}
  1. Ottieni la tua MCP API key da AnythingMCP → Profilo → MCP API Keys → Nuova Key.
  2. Salva il file e riavvia gemini.
  3. Esegui /mcp nella Gemini CLI — Etsy dovrebbe essere elencato come disponibile.
  4. Vertex AI Studio: passa https://cloud.anythingmcp.com/mcp nell'array tools della richiesta con lo stesso header Bearer.

Tool disponibili

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

FAQ

Gemini 1.5 Pro o 2.x supportano MCP? Sì — Gemini CLI ≥ 0.4 e la Vertex AI tools API accettano connettori MCP httpUrl con header Bearer.

Prossimi passi

Questa guida ti è stata utile?

Ready to ship

Your Etsy agent is one click away.

Install the connector, paste the key, prompt Gemini. Free for 7 days, no credit card.

Guide correlate