Etsy MCP Server

Etsy MCP Server

The Etsy MCP server bridges the gap between AI assistants and Etsy’s powerful V3 API. By exposing a set of Model Context Protocol tools, it removes the friction of OAuth authentication and routine API calls, allowing developers to focus on building creative workflows rather than plumbing. The server handles the full OAuth 2.0 PKCE flow, securely stores refresh tokens, and refreshes access tokens automatically—so an AI assistant can maintain a long‑lived session with Etsy without user intervention.

At its core, the server offers a curated toolkit that mirrors Etsy’s primary operations: creating and retrieving listings, fetching shop metadata, managing shipping profiles, and uploading images. Each function is wrapped as an MCP command, meaning a client can request a new listing or pull the latest shop statistics with a single JSON message. This tight coupling lets AI assistants, such as those running in Cursor IDE or other MCP‑compatible environments, embed Etsy actions directly into prompts or code generation tasks. For example, a user could ask the assistant to “list my new handmade scarf” and the assistant would orchestrate the OAuth flow, build the listing payload, upload images, and return a shareable link—all transparently.

The server’s key features are designed for rapid iteration in a development setting. It includes default‑shop management so multiple shops can be handled with minimal configuration, and it exposes a customizable shipping profile creation tool to streamline logistics. Secure token storage ensures that credentials never leave the server’s environment, satisfying Etsy’s API terms while keeping sensitive data out of client code. The built‑in PKCE support eliminates the need for a separate authorization server, simplifying deployment on local machines or CI pipelines.

Real‑world use cases span from automated inventory management to AI‑driven product optimization. A small business owner could let an assistant auto‑generate listings from a spreadsheet, while a data scientist might pull shop analytics into a notebook for trend analysis. Designers could use the image upload tool to batch‑post new artwork, and developers can integrate shipping profile logic into a broader e‑commerce workflow. Because the server speaks MCP, any client that understands the protocol can tap into Etsy’s capabilities—making it a versatile addition to an AI‑powered developer stack.