@bossforce.ai/mcp-woocommerce

MCP server for the WooCommerce REST API (v3). A good fit for order fulfilment workflows and keeping a product catalog in sync from an agent.

Credentials

| Env | How to obtain | | ----------------------------- | ------------------------------------------------------------------------------------------------------------- | | WOOCOMMERCE_URL | Base URL of the store, e.g. https://shop.example.com (the /wp-json/wc/v3 base is appended). | | WOOCOMMERCE_CONSUMER_KEY | REST API consumer key (ck_...) from WooCommerce → Settings → Advanced → REST API. | | WOOCOMMERCE_CONSUMER_SECRET | REST API consumer secret (cs_...) paired with the key. Grant Read/Write to create products / update orders. |

Auth is HTTP Basic over HTTPS: the consumer key is the username and the consumer secret is the password. Credentials are read lazily, so the server boots and answers tools/list without them; calls fail with an auth error until they are set. Plain HTTP stores (which require OAuth 1.0a) are not supported.

Tools

| Tool | Arguments | Returns | | ---------------- | -------------------------------------------------------------------------------------------------------------------- | ----------------- | | list_products | search?, status?, sku?, category?, per_page?, page? | Product[] | | create_product | name, type?, regular_price?, description?, short_description?, sku?, status?, categories?, images? | created Product | | list_orders | status?, customer?, search?, after?, before?, per_page?, page? | Order[] | | get_order | order_id | Order | | update_order | order_id, status?, customer_note? | updated Order |

Results are WooCommerce's native objects, returned as structuredContent. update_order requires at least one field besides order_id.

Develop

pnpm --filter @bossforce.ai/mcp-woocommerce build
pnpm --filter @bossforce.ai/mcp-woocommerce test

Regenerate the tools/list snapshot after an intentional signature change:

UPDATE_SNAPSHOTS=1 pnpm --filter @bossforce.ai/mcp-woocommerce test