Connector guide2-minute read9 MCP toolsEnglish · Deutsch · Italiano

Cómo conectar 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.

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Etsy, pega tus credenciales, genera una MCP API key — listo. Sin Docker, sin git clone, sin servidor local.

Etsy + Gemini

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

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

ETSY_API_KEY, ETSY_ACCESS_TOKEN

Paso 1 — Obtener credenciales

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)

Paso 2 — Instalar el adapter

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

Paso 3 — Añadir el conector en Gemini

Gemini CLI lee servidores MCP desde ~/.gemini/settings.json (o %APPDATA%\gemini\settings.json en Windows). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_API_KEY" }
    }
  }
}
  1. Obtén tu MCP API key desde AnythingMCP → Perfil → MCP API Keys → Nueva Key.
  2. Guarda el archivo y reinicia gemini.
  3. Ejecuta /mcp en la Gemini CLI — Etsy debería aparecer como disponible.
  4. Vertex AI Studio: pasa https://cloud.anythingmcp.com/mcp al array tools de tu petición con el mismo header Bearer.

Herramientas disponibles

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 soportan MCP? Sí — Gemini CLI ≥ 0.4 y la API de tools de Vertex AI aceptan conectores MCP httpUrl con header Bearer.

Siguientes pasos

¿Te ha sido útil esta guía?

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.

Guías relacionadas