What is etsy-mcp-server?

This project lets AI assistants like Claude Desktop manage an Etsy shop directly, by connecting the Etsy API to the Model Context Protocol, a standard way for AI tools to call external services. Once set up, an AI assistant can list a shop's products, view shop sections, check shipping and return policy settings, and create or update product listings on Etsy, all through plain conversation instead of using Etsy's own dashboard. It is built as an update to an earlier open source version of the same idea, adding support for several changes Etsy made to its API since that original was written. These include a new authentication header format, a newly required processing profile setting for physical products, and support for extra listing details like tags, materials, and shipping profile choices when creating or updating a listing. To use it, you need your own Etsy API key, shared secret, and an OAuth refresh token, which can be set as environment variables or stored in a settings file. The project includes a small helper script that opens a browser window to walk you through getting that refresh token if you do not already have one. Once configured, the server can be run directly with Node.js for local development, or packaged into a Docker container for more reliable deployment, including a ready made Docker Compose setup. This is not a service that runs constantly on its own. It waits quietly until an AI assistant or MCP compatible client connects to it, then responds to requests and exits again when the client is done. It is meant for Etsy sellers or developers who want to give an AI assistant hands on access to manage their shop's listings and settings.