Etsy MCP Server

What is Etsy MCP Server?

An MCP (Model Context Protocol) server that wraps the Etsy V3 API, handling OAuth 2.0 authentication (with PKCE token refresh), secure token storage, and providing tools for managing listings, shop details, shipping profiles, and image uploads. It is designed for developers integrating Etsy into MCP-compatible clients like Cursor IDE.

How to use Etsy MCP Server?

Install Node.js 18+, clone the repository, run npm install, copy .env.example to .env and fill in your Etsy API key and client secret, then run npm run dev for development or npm start after building. Configure the server in your MCP client by providing the command (npm run dev or npm start), environment variables, and the absolute path to the project as the working directory.

Key features of Etsy MCP Server

• OAuth2 authentication with PKCE flow and token refresh
• Create and retrieve Etsy listings
• Fetch shop details and manage default shop selection
• List and create shipping profiles
• Upload images and associate them with listings
• Secure, persistent token storage

Use cases of Etsy MCP Server

• Automate listing creation and image uploads from an AI assistant
• Retrieve shop inventory or shipping profile details on demand
• Integrate Etsy shop management into a custom MCP-powered workflow

FAQ from Etsy MCP Server

What runtime dependencies does Etsy MCP Server require?

Node.js version 18.0.0 or higher and npm (or yarn) are required. The server communicates via standard input/output with MCP clients.

How does authentication work?

The server initiates the Etsy OAuth2 flow with PKCE. When you call the authenticate() tool, it returns a URL to open in your browser to grant access; tokens are then stored securely for subsequent sessions.

Where are OAuth tokens stored?

Tokens are persisted to disk in a configurable token storage directory (set via the ETSY_MCP_TOKEN_PATH environment variable). The server automatically refreshes tokens when they expire.

How do I configure Etsy MCP Server in Cursor IDE?

Add a new MCP server in Cursor settings with the command npm, args ["run", "dev"], environment variables for ETSY_API_KEY and ETSY_CLIENT_SECRET (or rely on the .env file), and set the cwd to the absolute path of your project directory.

Can this server be used with any MCP client?

Yes. It implements the Model Context Protocol over standard input/output, so it works with any MCP-compatible client that supports stdio-based servers (e.g., Cursor IDE, other MCP hosts).