mcp-server-shopify

MCP serverCommerce & finance

Shopify Admin GraphQL API: products, orders, customers, inventory, and more (read and write).

This server has no hosted endpoint yet, so ahel can't serve it. You can still add it. It stays paused until ahel can serve it.

Serve it through your gateway

One link, every agent. Your own credentials, stored once.

Tools it gives your agents (28)

ToolWhat it does
shopify_list_productsList products with optional Shopify search query syntax (e.g. "status:active vendor:Acme"). Optional pagination via cursor. Default first=50, max=250.
shopify_get_productGet 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.
shopify_search_productsSearch products by Shopify search query (full-text + filters like "title:T-Shirt status:active"). Required: query. Optional pagination + sort.
shopify_create_productCreate a new product. Required: title. Optional: descriptionHtml, productType, vendor, tags, status (ACTIVE|ARCHIVED|DRAFT, default ACTIVE), handle. Returns product + userErrors.
shopify_update_productUpdate 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.
shopify_archive_productArchive 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.
shopify_add_product_tagAdd one or more tags to a product. Required: productId, tags (non-empty array). Idempotent server-side. Returns the updated product node + userErrors.
shopify_remove_product_tagRemove one or more tags from a product. Required: productId, tags (non-empty array). Returns the updated product node + userErrors.
shopify_list_ordersList orders with optional Shopify search query (e.g. "financial_status:paid created_at:>2026-01-01"). Default first=50, max=250.
shopify_get_orderGet a single order by GID or numeric ID. Returns full detail including line items (with truncation marker), customer, addresses, and financial totals.
shopify_search_ordersSearch orders by Shopify search query (e.g. "name:#1001 OR email:foo@bar.com"). Required: query.
shopify_mark_order_paidMark an order as paid (orderMarkAsPaid). Use for offline payments where the funds were captured outside Shopify. Returns updated order + userErrors.
shopify_cancel_orderCancel an order asynchronously (orderCancel returns a job). Destructive: requires confirm=true. Default reason=OTHER, restock=true, refund=false, notifyCustomer omitted.
shopify_add_order_noteAdd 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.
shopify_list_customersList customers with optional Shopify search query (e.g. "orders_count:>0 country:CH"). Default first=50, max=250.
shopify_get_customerGet a single customer by GID or numeric ID. Returns full detail including default address, addresses (with truncation marker), tags, locale, and lifetime value.
shopify_search_customersSearch customers by Shopify search query (e.g. "email:foo@bar.com OR last_name:Smith"). Required: query.
shopify_create_customerCreate a customer (customerCreate). At least one of email/phone is required. Optional: firstName, lastName, note, tags, locale.
shopify_update_customerUpdate a customer (customerUpdate). Required: id. All other fields are optional and only applied if provided.
shopify_add_customer_noteAdd 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.
shopify_get_inventory_levelGet the inventory level (available, on_hand, committed, incoming, reserved) for an inventory item at a single location. Required: inventoryItemId, locationId.
shopify_adjust_inventory_levelAdjust the available or on_hand quantity at a location by a delta (positive or negative integer, non-zero). Uses inventoryAdjustQuantities. Defaults: name=available, reason=correction.
shopify_create_draft_orderCreate a draft order. Required: lineItems (non-empty). Each line item needs quantity, plus either variantId (existing variant) or title+originalUnitPrice (custom item).
shopify_complete_draft_orderComplete a draft order, converting it into a real order (draftOrderComplete). Destructive: requires confirm=true. paymentPending=true marks the resulting order as payment pending instead of paid.
shopify_get_shop_infoGet shop-level metadata: name, primary domain, currency, timezone, plan, billing address, contact email, weight unit.
shopify_list_collectionsList collections with optional Shopify search query. Returns id, title, handle, descriptionHtml, sortOrder, productsCount.
shopify_list_locationsList shop locations (warehouses, retail stores). By default excludes inactive and legacy locations; toggle with includeInactive / includeLegacy.
shopify_list_metafieldsList metafields on any HasMetafields resource (Product, ProductVariant, Customer, Order, Collection, Shop, Company, Location). Required: ownerId, ownerType. Optional: namespace filter.

Signals

Last commit
Aug 2026
Tools captured
28

ahel review

  • S4info
    community integration — published by aiwerk, not shopify

Automated review, not a security audit. Ruleset v1.