Can I use Etsy as a CLI?

Yes. KosmoKrator exposes a Etsy CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Etsy through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Etsy tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Etsy credentials stored?

Etsy credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Etsy MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

ecommerce

Etsy CLI for Headless Automation

Use the Etsy CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.

6 functions 5 read 1 write Manual OAuth token auth

Submit Etsy feedback View package source

Etsy CLI for Headless Automation

Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.

Use headless automation when another tool needs a stable local command surface. The Etsy CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Etsy CLI for Headless Automation
kosmokrator integrations:configure etsy --set access_token="$ETSY_ACCESS_TOKEN" --set shop_id="$ETSY_SHOP_ID" --enable --read allow --write ask --json
kosmo integrations:call etsy.etsy_list_listings '{"state":"example_state","limit":1,"offset":1}' --json

Discovery Before Execution

Agents and scripts can inspect Etsy docs and schemas before choosing a function.

kosmo integrations:docs etsy --json
kosmo integrations:docs etsy.etsy_list_listings --json
kosmo integrations:schema etsy.etsy_list_listings --json
kosmo integrations:search "Etsy" --json
kosmo integrations:list --json

Useful Etsy CLI Functions

Function	Type	Parameters	Description
`etsy.etsy_list_listings`	Read	state, limit, offset	List all listings in the Etsy shop. Returns paginated results with optional state filtering (active, draft, inactive, expired).
`etsy.etsy_get_listing`	Read	listing_id	Get full details for a specific Etsy listing, including title, description, price, images, and state.
`etsy.etsy_create_listing`	Write	title, description, price, quantity, shipping_profile_id, taxonomy_id, tags, who_made, when_made, is_supply	Create a new listing in the Etsy shop. Requires a title, description, price, quantity, and shipping profile ID.
`etsy.etsy_list_orders`	Read	limit, offset, was_paid, was_shipped	List orders (receipts) for the Etsy shop. Returns paginated order data including buyer info, items, and totals.
`etsy.etsy_get_listing_inventory`	Read	listing_id	Get the inventory (products, offerings, and pricing) for a specific Etsy listing.
`etsy.etsy_get_current_user`	Read	none	Get the profile of the currently authenticated Etsy user, including user ID and primary shop info.

Automation Notes

Use --json for machine-readable output.
Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
Configure read/write policy before unattended runs; use --force only for trusted automation.
Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.

Related Etsy CLI Pages

CI Etsy CLI for CI. Cron Jobs Etsy CLI for cron jobs. Shell Scripts Etsy CLI for shell scripts. Coding Agents Etsy CLI for coding agents.