WooCommerce MCP Server

mcp-woocommerce

WooCommerce REST API 向けの本番環境対応 MCP サーバーです。商品、バリエーション、属性、注文、顧客、クーポン、レビュー、レポート、配送、決済、Webhook、一括操作、在庫、システム管理を網羅する 73 個のツールを提供します。

このプロジェクトの目的

WooCommerce は**すべての e コマースの 36%（有効なストアは 500 万以上）**を支えていますが、包括的な MCP サーバーは存在しません。このプロジェクトはその不足を補い、WooCommerce REST API v3 全体を網羅し、すべてのコアリソースに対する完全な CRUD を備えた、本番環境ですぐに使える 73 個のツールを提供します。

特長

• 18 カテゴリーにわたる 73 個のツール――利用可能な WooCommerce MCP サーバーの中で最も包括的です
• 完全な CRUD――商品、バリエーション、属性、属性ターム、カテゴリー、タグ、レビュー、注文、顧客、クーポン、Webhook に対応します
• 在庫管理――在庫切れおよび在庫僅少の商品を一覧表示します
• 一括操作――1 回の呼び出しで商品と注文を一括更新できます
• レポートと分析――売上レポート、売れ筋商品、注文数・商品数を確認できます
• ストア設定――設定、税区分、配送クラス、通貨、国を管理できます
• Webhook 管理――リアルタイムイベント向けの Webhook を作成、更新、一覧表示、削除できます
• システム診断――WooCommerce／WordPress のバージョン、プラグイン、サーバー環境を確認できます
• エラーセーフ――すべてのツールにエラー処理を実装しており、API エラーが発生してもクラッシュしません
• シンプルな認証――環境変数でコンシューマーキーとシークレットを指定します

クイックスタート

インストール

pip install mcp-woocommerce

設定

WooCommerce REST API の認証情報を環境変数に設定します。

export WOOCOMMERCE_URL="https://yourstore.com"
export WOOCOMMERCE_KEY="ck_your_consumer_key"
export WOOCOMMERCE_SECRET="cs_your_consumer_secret"

API キーは WordPress Admin > WooCommerce > Settings > Advanced > REST API で生成できます。

実行

mcp-woocommerce

モジュールとして実行することもできます。

python -m mcp_woocommerce

Claude Desktop で使用する

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "woocommerce": {
      "command": "mcp-woocommerce",
      "env": {
        "WOOCOMMERCE_URL": "https://yourstore.com",
        "WOOCOMMERCE_KEY": "ck_your_consumer_key",
        "WOOCOMMERCE_SECRET": "cs_your_consumer_secret"
      }
    }
  }
}

Claude Code で使用する

claude mcp add woocommerce -- mcp-woocommerce

その後、Claude Code を実行する前に、シェルで環境変数を設定します。

ツール（73 個）

ストア（1 個）

ツール	説明
ping	接続を検証し、ストア情報を取得します

商品（8 個）

ツール	説明
list_products	フィルター（ステータス、カテゴリー、検索、セール中かどうか）を指定して商品を一覧表示します
get_product	商品の詳細（価格、在庫、画像、属性）を取得します
create_product	商品（単純、バリエーションあり、グループ、外部）を作成します
update_product	商品のフィールド（価格、在庫、ステータスなど）を更新します
delete_product	商品を削除またはゴミ箱に移動します
search_products	商品名または SKU で検索します
list_low_stock_products	在庫状況（在庫切れ、入荷待ち）ごとに商品を一覧表示します

商品カテゴリー（4 個）

ツール	説明
list_product_categories	階層構造を含めてカテゴリーを一覧表示します
create_product_category	カテゴリーを作成します（サブカテゴリー用の親カテゴリーを任意で指定できます）
update_product_category	カテゴリー名、説明、スラッグ、親カテゴリーを更新します
delete_product_category	カテゴリーを削除します

商品バリエーション（5 個）

ツール	説明
list_product_variations	バリエーション商品に含まれるすべてのバリエーションを一覧表示します
get_product_variation	バリエーションの詳細（価格、在庫、属性）を取得します
create_product_variation	属性と価格を指定してバリエーションを作成します
update_product_variation	バリエーションの価格、在庫、ステータスを更新します
delete_product_variation	バリエーションを削除します

商品属性（5 個）

ツール	説明
list_product_attributes	すべての属性（例：色、サイズ）を一覧表示します
get_product_attribute	属性の詳細とタームを取得します
create_product_attribute	属性（選択式またはテキスト形式）を作成します
update_product_attribute	属性名、スラッグ、並び順を更新します
delete_product_attribute	すべての商品から属性を削除します

属性ターム（4）

ツール	説明
list_attribute_terms	属性のタームを一覧表示します（例：Color の Red、Blue）
create_attribute_term	属性にタームを追加します
update_attribute_term	タームの名前、スラッグ、説明を更新します
delete_attribute_term	タームを削除します

商品タグ（3）

ツール	説明
list_product_tags	オプションの検索条件を指定してタグを一覧表示します
create_product_tag	商品タグを作成します
delete_product_tag	商品タグを削除します

商品レビュー（4）

ツール	説明
list_product_reviews	レビューを一覧表示します（商品またはステータスで絞り込み）
get_product_review	レビューの詳細を取得します
create_product_review	評価を付けてレビューを作成します
delete_product_review	レビューを削除します

注文（10）

ツール	説明
list_orders	フィルター（ステータス、顧客、日付範囲）を指定して注文を一覧表示します
get_order	注文の詳細（商品、請求先、配送先、支払い）を取得します
create_order	明細項目を含む注文を作成します
update_order_status	注文ステータスを変更します（保留中、処理中、完了など）
update_order	注文の請求先／配送先住所と顧客メモを編集します
delete_order	注文を削除またはゴミ箱に移動します
list_order_notes	注文に関するすべてのメモを取得します
create_order_note	スタッフ向けまたは顧客向けのメモを追加します
create_refund	返金を実行します
list_refunds	注文のすべての返金を一覧表示します

顧客（6）

ツール	説明
list_customers	フィルター（ロール、検索）を指定して顧客を一覧表示します
get_customer	住所と注文統計を含む顧客の詳細を取得します
create_customer	新しい顧客を作成します
update_customer	顧客情報と請求先／配送先住所を更新します
delete_customer	顧客を削除します（オプションで注文を再割り当て）
search_customers	名前またはメールアドレスで検索します

クーポン（5）

ツール	説明
list_coupons	検索条件を指定してクーポンを一覧表示します
get_coupon	クーポンの詳細（制限、上限、使用状況）を取得します
create_coupon	割合割引、カート固定額割引、商品固定額割引のクーポンを作成します
update_coupon	クーポンの金額、有効期限、上限などを更新します
delete_coupon	クーポンを削除します

レポート（4）

ツール	説明
get_sales_report	期間（週、月、年、カスタム範囲）ごとの売上合計を取得します
get_top_sellers	期間ごとの売れ筋商品を取得します
get_order_totals	ステータスごとの注文数を取得します
get_product_totals	種類ごとの商品数を取得します

設定（1）

ツール	説明
get_store_settings	グループ（一般、商品、税など）ごとにストアの設定を読み取ります

配送と支払い（5）

ツール	説明
list_shipping_zones	配送ゾーンとその配送方法を一覧表示します
list_payment_gateways	決済ゲートウェイと有効状態を一覧表示します
list_tax_rates	設定済みのすべての税率を一覧表示します
list_tax_classes	税区分（標準、軽減、ゼロ税率）を一覧表示します
list_shipping_classes	商品の配送クラスを一覧表示します

Webhook（4）

ツール	説明
list_webhooks	すべての Webhook を一覧表示します
create_webhook	注文／商品／顧客イベント用の Webhook を作成します
update_webhook	Webhook の URL、トピック、ステータスを更新します
delete_webhook	Webhook を削除します

一括操作（2）

ツール	説明
batch_update_products	1 回の呼び出しで複数の商品を一括更新します
batch_update_orders	1 回の呼び出しで複数の注文を一括更新します

データ（2）

ツール	説明
list_currencies	対応するすべての通貨とコード、記号を一覧表示します
list_countries	州／県を含むすべての国を一覧表示します

システム（1）

ツール	説明
get_system_status	WooCommerce／WordPress のバージョン、プラグイン、サーバー環境を取得します

認証

WooCommerce では、REST API 認証にコンシューマーキー＋コンシューマーシークレットを使用します。このサーバーでは、HTTPS 経由の HTTP Basic 認証を使用します。

1. WordPress Admin > WooCommerce > Settings > Advanced > REST API に移動します
2. Add key をクリックします
3. 権限を Read/Write に設定します
4. コンシューマーキー（ck_...）とコンシューマーシークレット（cs_...）をコピーします

重要： Basic 認証を安全に使用するには、ストアで HTTPS が有効になっている必要があります。

要件

• Python 3.10+
• REST API v3 を備えた WooCommerce 3.5+
• ストアで HTTPS が有効になっていること

ライセンス

MIT