Etsy MCP Server

MCP server for the Etsy API

Local serverstdio

What is the Etsy MCP Server?

Etsy becomes available to MCP clients through the etsy mcp server. MCP server for the Etsy API.

What Etsy does

This project exposes a subset of the Etsy API through the Model Context Protocol. It allows tools to be called from an MCP client to retrieve shop data and manage listings.

Practical notes

  • Maintained by profplum700.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
getShopFetch information about a shop. Required argument: shop_id.
getMeReturn basic info about the authenticated user, including user_id and shop_id. This endpoint takes no arguments.
getListingsByShopList the listings in a shop. Supports an optional state parameter (e.g. active, draft). Requires shop_id.
createDraftListingCreate a new physical draft listing using POST /v3/application/shops/{shop_id}/listings. The tool accepts all fields supported by Etsy's createDraftListing endpoint.
uploadListingImageUpload an image to a listing. Requires shop_id, listing_id and image_path. (Implementation is currently a placeholder.)
updateListingUpdate an existing listing. Requires shop_id and listing_id. Optional fields include title, description and price.
getShopReceipts
getShopSectionsRetrieve the list of sections in a shop. Requires shop_id.
getShopSectionRetrieve a single shop section by shop_id and shop_section_id.
getSellerTaxonomyNodes
getPropertiesByTaxonomyIdList product properties supported for a specific taxonomy node. Requires taxonomy_id.

Configuration

VariableDescriptionRequired
ETSY_API_KEYCredential the server authenticates with.Yes
ETSY_SHARED_SECRETCredential the server authenticates with.Yes
ETSY_REFRESH_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • “Use Etsy to getShop.”
  • “Use Etsy to getMe.”
  • “Use Etsy to getListingsByShop.”

Frequently asked questions

MCP server for the Etsy API Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.