etsy-mcp-server
Allows interaction with Etsy's Open API v3, providing tools for managing shops, listings, orders, and messages.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Etsy MCP Server for OpenAI Agent Builder
This is a deployable remote MCP server that lets OpenAI Agent Builder connect directly to Etsy using Etsy OAuth 2.0 with PKCE.
Tools
etsy_get_my_shopsetsy_get_shopetsy_get_listingsetsy_create_listingetsy_update_listingetsy_get_ordersetsy_get_messagesetsy_reply_to_message
Important: Etsy's official OpenAPI v3 spec does not expose conversations/messages or reply endpoints. The two message tools are registered so Agent Builder can see the requested surface, but they return unsupported_by_etsy_open_api_v3 instead of faking unsupported Etsy calls.
Related MCP server: MCP OAuth Server
Environment Variables
PUBLIC_BASE_URL=https://your-deployed-etsy-mcp.example.com
PORT=3000
DATA_PATH=etsy-mcp-store.json
ETSY_CLIENT_ID=your_etsy_keystring
ETSY_API_KEYSTRING=your_etsy_keystring
ETSY_SHARED_SECRET=your_etsy_shared_secretETSY_CLIENT_ID and ETSY_API_KEYSTRING are normally the same Etsy keystring.
Etsy Developer Portal Setup
Go to
https://www.etsy.com/developers/your-apps.Create or open your Etsy app.
Copy the app keystring into
ETSY_CLIENT_IDandETSY_API_KEYSTRING.Copy the shared secret into
ETSY_SHARED_SECRET.Add this exact OAuth redirect URI:
https://your-deployed-etsy-mcp.example.com/oauth/etsy/callbackReplace the host with the real deployed host used in
PUBLIC_BASE_URL.The URI must be HTTPS and must match exactly. No trailing slash.
The server requests these Etsy scopes:
shops_r shops_w listings_r listings_w transactions_r transactions_wLocal Development
npm install
cp .env.example .env
npm run devFor local Agent Builder testing, expose the server with an HTTPS tunnel and set:
PUBLIC_BASE_URL=https://your-tunnel-hostThen add this redirect URI to Etsy:
https://your-tunnel-host/oauth/etsy/callbackDeployment
Deploy to any Node host that supports persistent storage for the JSON token store, such as Render, Railway, Fly.io, or a VPS.
Build command:
npm install && npm run buildStart command:
npm startSet all environment variables in the hosting provider.
If your platform has ephemeral disk, set DATA_PATH to a mounted persistent volume path or replace the JSON store with Postgres/Redis before production use.
OpenAI Agent Builder Setup
In Agent Builder, add a remote MCP connection:
Field | Value |
MCP Server URL |
|
Authentication | OAuth |
Headers | None |
Do not use:
https://your-deployed-etsy-mcp.example.com/mcp
https://your-deployed-etsy-mcp.example.com/sseWhen Agent Builder connects, it discovers:
https://your-deployed-etsy-mcp.example.com/.well-known/oauth-protected-resource
https://your-deployed-etsy-mcp.example.com/.well-known/oauth-authorization-serverThe OAuth flow then sends Employee #1 to Etsy, Employee #1 approves the Etsy app, and Agent Builder receives an MCP bearer token for subsequent tool calls.
Etsy API Routes Used
The server calls Etsy Open API v3:
GET /v3/application/users/{user_id}/shops
GET /v3/application/shops/{shop_id}
GET /v3/application/shops/{shop_id}/listings
GET /v3/application/shops/{shop_id}/listings/active
POST /v3/application/shops/{shop_id}/listings
PATCH /v3/application/shops/{shop_id}/listings/{listing_id}
GET /v3/application/shops/{shop_id}/receiptsEvery Etsy API call sends:
Authorization: Bearer <etsy_oauth_access_token>
x-api-key: <keystring>:<shared_secret>Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Connect any AI agent to 1,000+ apps and 27,000+ actions through one remote MCP server (OAuth).
The Stytch MCP server is a reference implementation that demonstrates remote MCP server authentication and authorization using Stytch Connected Apps. It provides OAuth 2.1-compliant authorization (including PKCE), Dynamic Client Registration, and validates Stytch-issued access tokens to enable AI agents to securely interact with external services through permissioned access, supporting scopes like openid, email, profile, and manage:project_data.
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
The Remote MCP server acts as a standardized bridge between LLM applications (like Claude, ChatGPT, and Cursor) and external services, enabling AI agents to access external tools and resources. Its primary capability is providing a centralized search tool to discover other MCP servers and their respective tools. Unlike local implementations, it runs remotely with OAuth authentication and permission controls for security.
Related MCP Servers
- AlicenseAqualityDmaintenanceA production-grade MCP server that enables AI assistants like Claude to read Etsy shop data—listings, orders, inventory, and stats—through eight read-only tools, using OAuth and automatic pagination.8MIT
- AlicenseNot gradedqualityDmaintenanceA Node.js MCP server with custom OAuth 2.1 + PKCE authentication, enabling secure remote connections to LLMs like Claude and ChatGPT.ISC
- AlicenseAqualityDmaintenanceA full-featured MCP server for the Etsy Open API v3 that enables managing an Etsy shop, including listings, inventory, images, digital files, and orders, through Claude or any MCP-compatible client.262MIT
- AlicenseNot gradedqualityCmaintenanceA spec-compliant remote MCP server with built-in OAuth 2.1 and Dynamic Client Registration, enabling Notion Custom Agents to connect via 'Sign in with OAuth' without bearer tokens. It supports SSO federation to Google and Microsoft Entra, and includes basic tools like whoami, echo, and slow_task.MIT