Shopify Admin

List products with optional Shopify search query syntax (e.g. "status:active vendor:Acme"). Optional pagination via cursor. Default first=50, max=250.

{
  "tool": "shopify_list_products",
  "arguments": {
    "first": 0,
    "after": "…",
    "query": "…"
  }
}

Get a product by GID or numeric ID (e.g. "gid://shopify/Product/123" or "123"). Returns full product detail including variants and images, with truncation markers when capped.

{
  "tool": "shopify_get_product",
  "arguments": {
    "id": "…"
  }
}

Search products by Shopify search query (full-text + filters like "title:T-Shirt status:active"). Required: query. Optional pagination + sort.

{
  "tool": "shopify_search_products",
  "arguments": {
    "query": "…"
  }
}

Create a new product. Required: title. Optional: descriptionHtml, productType, vendor, tags, status (ACTIVE|ARCHIVED|DRAFT, default ACTIVE), handle. Returns product + userErrors.

{
  "tool": "shopify_create_product",
  "arguments": {
    "title": "…"
  }
}

Update fields on an existing product by GID or numeric ID. Required: id. All other fields are optional and only applied if provided. Returns product + userErrors.

{
  "tool": "shopify_update_product",
  "arguments": {
    "id": "…"
  }
}

Archive a product (sets status to ARCHIVED, hiding it from sale). Reversible. Destructive: requires confirm=true. Without confirm, returns a structured "would do X" response without firing.

{
  "tool": "shopify_archive_product",
  "arguments": {
    "id": "…"
  }
}

Add one or more tags to a product. Required: productId, tags (non-empty array). Idempotent server-side. Returns the updated product node + userErrors.

{
  "tool": "shopify_add_product_tag",
  "arguments": {
    "productId": "…",
    "tags": []
  }
}

Remove one or more tags from a product. Required: productId, tags (non-empty array). Returns the updated product node + userErrors.

{
  "tool": "shopify_remove_product_tag",
  "arguments": {
    "productId": "…",
    "tags": []
  }
}

List orders with optional Shopify search query (e.g. "financial_status:paid created_at:>2026-01-01"). Default first=50, max=250.

{
  "tool": "shopify_list_orders",
  "arguments": {
    "first": 0,
    "after": "…",
    "query": "…"
  }
}

Get a single order by GID or numeric ID. Returns full detail including line items (with truncation marker), customer, addresses, and financial totals.

{
  "tool": "shopify_get_order",
  "arguments": {
    "id": "…"
  }
}

Search orders by Shopify search query (e.g. "name:#1001 OR email:foo@bar.com"). Required: query.

{
  "tool": "shopify_search_orders",
  "arguments": {
    "query": "…"
  }
}

Mark an order as paid (orderMarkAsPaid). Use for offline payments where the funds were captured outside Shopify. Returns updated order + userErrors.

{
  "tool": "shopify_mark_order_paid",
  "arguments": {
    "id": "…"
  }
}

Cancel an order asynchronously (orderCancel returns a job). Destructive: requires confirm=true. Default reason=OTHER, restock=true, refund=false, notifyCustomer omitted.

{
  "tool": "shopify_cancel_order",
  "arguments": {
    "id": "…"
  }
}

Add a note to an order. mode=append (default) reads the current note and concatenates with two newlines; mode=replace overwrites. Required: id, note. Append makes one extra read query.

{
  "tool": "shopify_add_order_note",
  "arguments": {
    "id": "…",
    "note": "…"
  }
}

List customers with optional Shopify search query (e.g. "orders_count:>0 country:CH"). Default first=50, max=250.

{
  "tool": "shopify_list_customers",
  "arguments": {
    "first": 0,
    "after": "…",
    "query": "…"
  }
}

Get a single customer by GID or numeric ID. Returns full detail including default address, addresses (with truncation marker), tags, locale, and lifetime value.

{
  "tool": "shopify_get_customer",
  "arguments": {
    "id": "…"
  }
}

Search customers by Shopify search query (e.g. "email:foo@bar.com OR last_name:Smith"). Required: query.

{
  "tool": "shopify_search_customers",
  "arguments": {
    "query": "…"
  }
}

Create a customer (customerCreate). At least one of email/phone is required. Optional: firstName, lastName, note, tags, locale.

{
  "tool": "shopify_create_customer",
  "arguments": {
    "firstName": "…",
    "lastName": "…",
    "email": "…"
  }
}

Update a customer (customerUpdate). Required: id. All other fields are optional and only applied if provided.

{
  "tool": "shopify_update_customer",
  "arguments": {
    "id": "…"
  }
}

Add a note to a customer. mode=append (default) reads the current note and concatenates with two newlines; mode=replace overwrites. Append makes one extra read query.

{
  "tool": "shopify_add_customer_note",
  "arguments": {
    "id": "…",
    "note": "…"
  }
}