Shopify

Shopify MCP Server for Cloudflare Workers

Available Tools

110 tools available in the Shopify MCP server. Each tool can be called by AI assistants to perform specific actions.

shopify_get_collection

Get any collection by ID (custom or smart).

Args:

collectionId: Collection ID
format: Response format

Returns: The collection details.

{
  "type": "object",
  "required": [
    "collectionId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "collectionId": {
      "type": "number",
      "description": "Collection ID"
    }
  }
}

shopify_open_order

Re-open a closed order.

Args:

orderId: Order ID to open

Returns: The re-opened order.

{
  "type": "object",
  "required": [
    "orderId"
  ],
  "properties": {
    "orderId": {
      "type": "number",
      "description": "Order ID"
    }
  }
}

shopify_delete_discount_code

Delete a discount code.

Args:

priceRuleId: Price rule ID
discountCodeId: Discount code ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "priceRuleId",
    "discountCodeId"
  ],
  "properties": {
    "priceRuleId": {
      "type": "number",
      "description": "Price rule ID"
    },
    "discountCodeId": {
      "type": "number",
      "description": "Discount code ID"
    }
  }
}

shopify_get_fulfillment_order

Get a single fulfillment order by ID.

Args:

fulfillmentOrderId: Fulfillment order ID
format: Response format

Returns: The fulfillment order details.

{
  "type": "object",
  "required": [
    "fulfillmentOrderId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "fulfillmentOrderId": {
      "type": "number",
      "description": "Fulfillment order ID"
    }
  }
}

shopify_update_smart_collection

Update an existing smart collection.

Args:

collectionId: Collection ID to update
title: New title
rules: New rules array
disjunctive: New disjunctive setting
bodyHtml: New description
handle: New handle
published: New published state
sortOrder: New sort order

Returns: The updated smart collection.

{
  "type": "object",
  "required": [
    "collectionId"
  ],
  "properties": {
    "title": {
      "type": "string"
    },
    "handle": {
      "type": "string"
    },
    "bodyHtml": {
      "type": "string"
    },
    "published": {
      "type": "boolean"
    },
    "disjunctive": {
      "type": "boolean"
    },
    "collectionId": {
      "type": "number",
      "description": "Collection ID"
    }
  }
}

shopify_delete_smart_collection

Delete a smart collection.

Args:

collectionId: Collection ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "collectionId"
  ],
  "properties": {
    "collectionId": {
      "type": "number",
      "description": "Collection ID"
    }
  }
}

shopify_list_custom_collections

List custom collections with pagination and filters.

Custom collections are manually curated product groups.

Args:

limit: Number of collections to return (1-250, default: 50)
sinceId: Return collections after this ID
title: Filter by title
productId: Filter by product
handle: Filter by handle
publishedStatus: Filter by published status
format: Response format

Returns: Paginated list of custom collections.

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "handle": {
      "type": "string"
    },
    "sinceId": {
      "type": "string"
    },
    "productId": {
      "type": "string"
    },
    "publishedStatus": {
      "enum": [
        "published",
        "unpublished",
        "any"
      ],
      "type": "string"
    }
  }
}

shopify_get_custom_collection

Get a single custom collection by ID.

Args:

collectionId: Collection ID
format: Response format

Returns: The custom collection details.

{
  "type": "object",
  "required": [
    "collectionId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "collectionId": {
      "type": "number",
      "description": "Collection ID"
    }
  }
}

shopify_create_custom_collection

Create a new custom collection.

Args:

title: Collection title (required)
bodyHtml: Description HTML
handle: URL handle
published: Whether to publish
sortOrder: Sort order (alpha-asc, alpha-desc, best-selling, created, created-desc, manual, price-asc, price-desc)
image: Image object with src or attachment

Returns: The created collection.

{
  "type": "object",
  "required": [
    "title"
  ],
  "properties": {
    "image": {
      "type": "object"
    },
    "title": {
      "type": "string",
      "description": "Collection title (required)"
    },
    "handle": {
      "type": "string"
    },
    "bodyHtml": {
      "type": "string"
    },
    "published": {
      "type": "boolean"
    }
  }
}

shopify_update_custom_collection

Update an existing custom collection.

Args:

collectionId: Collection ID to update
title: New title
bodyHtml: New description
handle: New handle
published: New published state
sortOrder: New sort order

Returns: The updated collection.

{
  "type": "object",
  "required": [
    "collectionId"
  ],
  "properties": {
    "title": {
      "type": "string"
    },
    "handle": {
      "type": "string"
    },
    "bodyHtml": {
      "type": "string"
    },
    "published": {
      "type": "boolean"
    },
    "collectionId": {
      "type": "number",
      "description": "Collection ID"
    }
  }
}

shopify_delete_custom_collection

Delete a custom collection.

Args:

collectionId: Collection ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "collectionId"
  ],
  "properties": {
    "collectionId": {
      "type": "number",
      "description": "Collection ID"
    }
  }
}

shopify_list_smart_collections

List smart collections with pagination and filters.

Smart collections automatically include products based on rules.

Args:

limit: Number of collections to return (1-250, default: 50)
sinceId: Return collections after this ID
title: Filter by title
productId: Filter by product
handle: Filter by handle
publishedStatus: Filter by published status
format: Response format

Returns: Paginated list of smart collections.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 250,
      "minimum": 1
    },
    "title": {
      "type": "string"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "handle": {
      "type": "string"
    },
    "sinceId": {
      "type": "string"
    },
    "productId": {
      "type": "string"
    },
    "publishedStatus": {
      "enum": [
        "published",
        "unpublished",
        "any"
      ],
      "type": "string"
    }
  }
}

shopify_get_smart_collection

Get a single smart collection by ID.

Args:

collectionId: Collection ID
format: Response format

Returns: The smart collection with its rules.

{
  "type": "object",
  "required": [
    "collectionId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "collectionId": {
      "type": "number",
      "description": "Collection ID"
    }
  }
}

shopify_create_smart_collection

Create a new smart collection with automated rules.

Args:

title: Collection title (required)
rules: Array of rule objects (required)
- column: Field to match (title, type, vendor, variant_price, tag, etc.)
- relation: Comparison (equals, not_equals, greater_than, less_than, starts_with, ends_with, contains)
- condition: Value to match
disjunctive: If true, products match ANY rule; if false, products must match ALL rules
bodyHtml: Description HTML
handle: URL handle
published: Whether to publish
sortOrder: Sort order

Returns: The created smart collection.

{
  "type": "object",
  "required": [
    "title"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Collection title (required)"
    },
    "handle": {
      "type": "string"
    },
    "bodyHtml": {
      "type": "string"
    },
    "published": {
      "type": "boolean"
    },
    "disjunctive": {
      "type": "boolean",
      "description": "Match any rule (true) or all rules (false)"
    }
  }
}

shopify_list_collection_products

List products in a collection.

Args:

collectionId: Collection ID
limit: Number of products to return
format: Response format

Returns: Paginated list of products in the collection.

{
  "type": "object",
  "required": [
    "collectionId"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 250,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "collectionId": {
      "type": "number",
      "description": "Collection ID"
    }
  }
}

shopify_list_collects

List product-collection relationships (collects).

Collects link products to custom collections.

Args:

limit: Number of collects to return
productId: Filter by product ID
collectionId: Filter by collection ID
format: Response format

Returns: List of collect relationships.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 250,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "productId": {
      "type": "string"
    },
    "collectionId": {
      "type": "string"
    }
  }
}

shopify_create_collect

Add a product to a custom collection.

Args:

productId: Product ID to add
collectionId: Collection ID to add to
position: Position in collection (optional)

Returns: The created collect relationship.

{
  "type": "object",
  "required": [
    "productId",
    "collectionId"
  ],
  "properties": {
    "position": {
      "type": "number",
      "description": "Position in collection"
    },
    "productId": {
      "type": "number",
      "description": "Product ID"
    },
    "collectionId": {
      "type": "number",
      "description": "Collection ID"
    }
  }
}

shopify_delete_collect

Remove a product from a custom collection.

Args:

collectId: Collect ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "collectId"
  ],
  "properties": {
    "collectId": {
      "type": "number",
      "description": "Collect ID"
    }
  }
}

shopify_list_customers

List customers from the store with pagination and filters.

Args:

limit: Number of customers to return (1-250, default: 50)
sinceId: Return customers after this ID
ids: Comma-separated list of customer IDs
createdAtMin: Minimum created date (ISO 8601)
createdAtMax: Maximum created date (ISO 8601)
updatedAtMin: Minimum updated date
updatedAtMax: Maximum updated date
format: Response format

Returns: Paginated list of customers.

{
  "type": "object",
  "properties": {
    "ids": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 250,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "sinceId": {
      "type": "string"
    },
    "createdAtMax": {
      "type": "string"
    },
    "createdAtMin": {
      "type": "string"
    },
    "updatedAtMax": {
      "type": "string"
    },
    "updatedAtMin": {
      "type": "string"
    }
  }
}

shopify_get_customer

Get a single customer by ID.

Args:

customerId: The customer ID
format: Response format

Returns: The customer with all details including addresses.

{
  "type": "object",
  "required": [
    "customerId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "customerId": {
      "type": "number",
      "description": "Customer ID"
    }
  }
}

shopify_create_customer

Create a new customer.

Args:

email: Customer email (required)
firstName: First name
lastName: Last name
phone: Phone number (E.164 format)
note: Customer note
tags: Comma-separated tags
acceptsMarketing: Marketing consent
addresses: Array of address objects
sendEmailWelcome: Send welcome email
sendEmailInvite: Send account invite email

Returns: The created customer.

{
  "type": "object",
  "required": [
    "email"
  ],
  "properties": {
    "note": {
      "type": "string"
    },
    "tags": {
      "type": "string"
    },
    "email": {
      "type": "string",
      "description": "Customer email (required)"
    },
    "phone": {
      "type": "string"
    },
    "lastName": {
      "type": "string"
    },
    "firstName": {
      "type": "string"
    },
    "sendEmailInvite": {
      "type": "boolean"
    },
    "acceptsMarketing": {
      "type": "boolean"
    },
    "sendEmailWelcome": {
      "type": "boolean"
    }
  }
}

shopify_update_customer

Update an existing customer.

Args:

customerId: Customer ID to update
email: New email
firstName: New first name
lastName: New last name
phone: New phone
note: New note
tags: New tags
acceptsMarketing: New marketing consent

Returns: The updated customer.

{
  "type": "object",
  "required": [
    "customerId"
  ],
  "properties": {
    "note": {
      "type": "string"
    },
    "tags": {
      "type": "string"
    },
    "email": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "lastName": {
      "type": "string"
    },
    "firstName": {
      "type": "string"
    },
    "customerId": {
      "type": "number",
      "description": "Customer ID"
    },
    "acceptsMarketing": {
      "type": "boolean"
    }
  }
}

shopify_delete_customer

Delete a customer.

Note: Customers with orders cannot be deleted.

Args:

customerId: Customer ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "customerId"
  ],
  "properties": {
    "customerId": {
      "type": "number",
      "description": "Customer ID"
    }
  }
}

shopify_get_customer_count

Get the count of customers matching filters.

Args:

createdAtMin: Minimum created date
createdAtMax: Maximum created date
updatedAtMin: Minimum updated date
updatedAtMax: Maximum updated date

Returns: Count of matching customers.

{
  "type": "object",
  "properties": {
    "createdAtMax": {
      "type": "string"
    },
    "createdAtMin": {
      "type": "string"
    },
    "updatedAtMax": {
      "type": "string"
    },
    "updatedAtMin": {
      "type": "string"
    }
  }
}

shopify_list_locations

List all inventory locations.

Locations are places where you store inventory (warehouses, retail stores, etc.).

Args:

limit: Number of locations to return
format: Response format

Returns: List of inventory locations.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 250,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

shopify_search_customers

Search for customers by query string.

The query can search across multiple fields like email, name, etc.

Args:

query: Search query (required)
limit: Number of results to return
order: Sort order (e.g., "last_order_date DESC")
format: Response format

Returns: Matching customers.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 250,
      "minimum": 1
    },
    "order": {
      "type": "string"
    },
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

shopify_get_customer_orders

Get orders for a specific customer.

Args:

customerId: Customer ID
limit: Number of orders to return
status: Order status filter (any, open, closed, cancelled)
format: Response format

Returns: Customer's orders.

{
  "type": "object",
  "required": [
    "customerId"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 250,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "status": {
      "enum": [
        "any",
        "open",
        "closed",
        "cancelled"
      ],
      "type": "string"
    },
    "customerId": {
      "type": "number",
      "description": "Customer ID"
    }
  }
}

shopify_list_price_rules

List price rules with pagination and filters.

Price rules define discount logic (percentage off, fixed amount, buy X get Y, etc.).

Args:

limit: Number of price rules to return (1-250, default: 50)
sinceId: Return price rules after this ID
startsAt: Filter by start date
endsAt: Filter by end date
format: Response format

Returns: Paginated list of price rules.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 250,
      "minimum": 1
    },
    "endsAt": {
      "type": "string"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "sinceId": {
      "type": "string"
    },
    "startsAt": {
      "type": "string"
    }
  }
}

shopify_get_price_rule

Get a single price rule by ID.

Args:

priceRuleId: Price rule ID
format: Response format

Returns: The price rule details.

{
  "type": "object",
  "required": [
    "priceRuleId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "priceRuleId": {
      "type": "number",
      "description": "Price rule ID"
    }
  }
}

shopify_create_price_rule

Create a new price rule.

Args:

title: Price rule title (required)
targetType: What the rule applies to (line_item, shipping_line)
targetSelection: Which items to apply to (all, entitled)
allocationMethod: How to apply discount (across, each)
valueType: Type of discount (fixed_amount, percentage)
value: Discount value (negative for discounts, e.g., "-10.00" or "-10")
customerSelection: Who can use (all, prerequisite)
startsAt: Start date (ISO 8601)
endsAt: End date (ISO 8601, optional)
oncePerCustomer: Limit to one use per customer
usageLimit: Total usage limit
prerequisiteSubtotalRange: Minimum subtotal requirement
prerequisiteQuantityRange: Minimum quantity requirement
prerequisiteToEntitlementQuantityRatio: Buy X get Y ratio
entitledProductIds: Product IDs the discount applies to
entitledVariantIds: Variant IDs the discount applies to
entitledCollectionIds: Collection IDs the discount applies to
entitledCountryIds: Country IDs for shipping discounts
prerequisiteProductIds: Required product IDs
prerequisiteVariantIds: Required variant IDs
prerequisiteCollectionIds: Required collection IDs
prerequisiteCustomerIds: Required customer IDs

Returns: The created price rule.

{
  "type": "object",
  "required": [
    "title",
    "targetType",
    "targetSelection",
    "allocationMethod",
    "valueType",
    "value",
    "customerSelection",
    "startsAt"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Price rule title (required)"
    },
    "value": {
      "type": "string",
      "description": "Discount value (negative, e.g., \"-10.00"
    },
    "endsAt": {
      "type": "string"
    },
    "startsAt": {
      "type": "string",
      "description": "Start date (ISO 8601)"
    },
    "valueType": {
      "enum": [
        "fixed_amount",
        "percentage"
      ],
      "type": "string",
      "description": "Value type"
    },
    "targetType": {
      "enum": [
        "line_item",
        "shipping_line"
      ],
      "type": "string",
      "description": "Target type"
    },
    "usageLimit": {
      "type": "number"
    },
    "oncePerCustomer": {
      "type": "boolean"
    },
    "targetSelection": {
      "enum": [
        "all",
        "entitled"
      ],
      "type": "string",
      "description": "Target selection"
    },
    "allocationMethod": {
      "enum": [
        "across",
        "each"
      ],
      "type": "string",
      "description": "Allocation method"
    },
    "customerSelection": {
      "enum": [
        "all",
        "prerequisite"
      ],
      "type": "string",
      "description": "Customer selection"
    },
    "entitledCountryIds": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "entitledProductIds": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "entitledVariantIds": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "entitledCollectionIds": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "prerequisiteProductIds": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "prerequisiteVariantIds": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "prerequisiteCustomerIds": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "prerequisiteCollectionIds": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "prerequisiteQuantityRange": {
      "type": "object"
    },
    "prerequisiteSubtotalRange": {
      "type": "object"
    }
  }
}

shopify_update_price_rule

Update an existing price rule.

Args:

priceRuleId: Price rule ID to update
title: New title
value: New discount value
startsAt: New start date
endsAt: New end date
usageLimit: New usage limit
oncePerCustomer: New once per customer setting

Returns: The updated price rule.

{
  "type": "object",
  "required": [
    "priceRuleId"
  ],
  "properties": {
    "title": {
      "type": "string"
    },
    "value": {
      "type": "string"
    },
    "endsAt": {
      "type": "string"
    },
    "startsAt": {
      "type": "string"
    },
    "usageLimit": {
      "type": "number"
    },
    "priceRuleId": {
      "type": "number",
      "description": "Price rule ID"
    },
    "oncePerCustomer": {
      "type": "boolean"
    }
  }
}

shopify_delete_price_rule

Delete a price rule and all associated discount codes.

Args:

priceRuleId: Price rule ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "priceRuleId"
  ],
  "properties": {
    "priceRuleId": {
      "type": "number",
      "description": "Price rule ID"
    }
  }
}

shopify_list_discount_codes

List discount codes for a price rule.

Discount codes are the actual codes customers enter at checkout.

Args:

priceRuleId: Price rule ID
format: Response format

Returns: List of discount codes.

{
  "type": "object",
  "required": [
    "priceRuleId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "priceRuleId": {
      "type": "number",
      "description": "Price rule ID"
    }
  }
}

shopify_get_discount_code

Get a single discount code by ID.

Args:

priceRuleId: Price rule ID
discountCodeId: Discount code ID
format: Response format

Returns: The discount code details.

{
  "type": "object",
  "required": [
    "priceRuleId",
    "discountCodeId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "priceRuleId": {
      "type": "number",
      "description": "Price rule ID"
    },
    "discountCodeId": {
      "type": "number",
      "description": "Discount code ID"
    }
  }
}

shopify_create_discount_code

Create a discount code for a price rule.

Args:

priceRuleId: Price rule ID
code: The discount code string (required, e.g., "SAVE10")

Returns: The created discount code.

{
  "type": "object",
  "required": [
    "priceRuleId",
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "description": "Discount code string"
    },
    "priceRuleId": {
      "type": "number",
      "description": "Price rule ID"
    }
  }
}

shopify_update_discount_code

Update a discount code.

Args:

priceRuleId: Price rule ID
discountCodeId: Discount code ID
code: New discount code string

Returns: The updated discount code.

{
  "type": "object",
  "required": [
    "priceRuleId",
    "discountCodeId",
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "description": "New discount code string"
    },
    "priceRuleId": {
      "type": "number",
      "description": "Price rule ID"
    },
    "discountCodeId": {
      "type": "number",
      "description": "Discount code ID"
    }
  }
}

shopify_get_location

Get a single location by ID.

Args:

locationId: Location ID
format: Response format

Returns: The location details.

{
  "type": "object",
  "required": [
    "locationId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "locationId": {
      "type": "number",
      "description": "Location ID"
    }
  }
}

shopify_list_draft_orders

List draft orders with pagination and filters.

Draft orders are orders that haven't been completed yet.

Args:

limit: Number of draft orders to return (1-250, default: 50)
sinceId: Return draft orders after this ID
status: Filter by status (open, invoice_sent, completed)
updatedAtMin: Minimum updated date
updatedAtMax: Maximum updated date
format: Response format

Returns: Paginated list of draft orders.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 250,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "status": {
      "enum": [
        "open",
        "invoice_sent",
        "completed"
      ],
      "type": "string"
    },
    "sinceId": {
      "type": "string"
    },
    "updatedAtMax": {
      "type": "string"
    },
    "updatedAtMin": {
      "type": "string"
    }
  }
}

shopify_get_draft_order

Get a single draft order by ID.

Args:

draftOrderId: Draft order ID
format: Response format

Returns: The draft order with all details.

{
  "type": "object",
  "required": [
    "draftOrderId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "draftOrderId": {
      "type": "number",
      "description": "Draft order ID"
    }
  }
}

shopify_create_draft_order

Create a new draft order.

Args:

lineItems: Array of line items (required)
- variantId: Product variant ID
- title: Custom line item title
- quantity: Quantity
- price: Price per item
customer: Customer object (id or email)
email: Customer email
shippingAddress: Shipping address object
billingAddress: Billing address object
note: Order note
tags: Comma-separated tags
useCustomerDefaultAddress: Use customer's default address
taxExempt: Whether order is tax exempt
appliedDiscount: Discount to apply
- title: Discount title
- value: Discount value
- valueType: Type (fixed_amount or percentage)

Returns: The created draft order.

{
  "type": "object",
  "properties": {
    "note": {
      "type": "string"
    },
    "tags": {
      "type": "string"
    },
    "email": {
      "type": "string"
    },
    "customer": {
      "type": "object"
    },
    "taxExempt": {
      "type": "boolean"
    },
    "useCustomerDefaultAddress": {
      "type": "boolean"
    }
  }
}

shopify_update_draft_order

Update an existing draft order.

Args:

draftOrderId: Draft order ID
lineItems: New line items array
customer: New customer
email: New email
shippingAddress: New shipping address
billingAddress: New billing address
note: New note
tags: New tags
appliedDiscount: New discount

Returns: The updated draft order.

{
  "type": "object",
  "properties": {
    "note": {
      "type": "string"
    },
    "tags": {
      "type": "string"
    },
    "email": {
      "type": "string"
    },
    "customer": {
      "type": "object"
    },
    "draftOrderId": {
      "type": "number",
      "description": "Draft order ID"
    }
  }
}

shopify_delete_draft_order

Delete a draft order.

Args:

draftOrderId: Draft order ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "draftOrderId"
  ],
  "properties": {
    "draftOrderId": {
      "type": "number",
      "description": "Draft order ID"
    }
  }
}

shopify_complete_draft_order

Complete a draft order and convert it to a real order.

Args:

draftOrderId: Draft order ID to complete
paymentPending: If true, marks payment as pending (default: false)

Returns: The completed draft order with the created order ID.

{
  "type": "object",
  "required": [
    "draftOrderId"
  ],
  "properties": {
    "draftOrderId": {
      "type": "number",
      "description": "Draft order ID"
    },
    "paymentPending": {
      "type": "boolean"
    }
  }
}

shopify_send_draft_order_invoice

Send an invoice for a draft order to the customer.

Args:

draftOrderId: Draft order ID
to: Recipient email (optional, defaults to customer email)
from: Sender email (optional, defaults to shop email)
subject: Email subject (optional)
customMessage: Custom message to include (optional)

Returns: The invoice details.

{
  "type": "object",
  "required": [
    "draftOrderId"
  ],
  "properties": {
    "to": {
      "type": "string"
    },
    "from": {
      "type": "string"
    },
    "subject": {
      "type": "string"
    },
    "draftOrderId": {
      "type": "number",
      "description": "Draft order ID"
    },
    "customMessage": {
      "type": "string"
    }
  }
}

shopify_list_fulfillments

List fulfillments for an order.

Args:

orderId: Order ID
limit: Number of fulfillments to return
format: Response format

Returns: List of fulfillments with tracking information.

{
  "type": "object",
  "required": [
    "orderId"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 250,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "orderId": {
      "type": "number",
      "description": "Order ID"
    }
  }
}

shopify_get_fulfillment

Get a single fulfillment by ID.

Args:

orderId: Order ID
fulfillmentId: Fulfillment ID
format: Response format

Returns: The fulfillment details.

{
  "type": "object",
  "required": [
    "orderId",
    "fulfillmentId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "orderId": {
      "type": "number",
      "description": "Order ID"
    },
    "fulfillmentId": {
      "type": "number",
      "description": "Fulfillment ID"
    }
  }
}

shopify_create_fulfillment

Create a fulfillment for fulfillment orders.

This uses the new Fulfillment Orders API.

Args:

lineItemsByFulfillmentOrder: Array of fulfillment order line items
- fulfillmentOrderId: Fulfillment order ID
- fulfillmentOrderLineItems: Array of { id, quantity }
trackingInfo: Tracking information object
- number: Tracking number
- url: Tracking URL
- company: Shipping company
notifyCustomer: Whether to send shipping notification

Returns: The created fulfillment.

{
  "type": "object",
  "properties": {
    "notifyCustomer": {
      "type": "boolean"
    }
  }
}

shopify_update_fulfillment_tracking

Update tracking information for a fulfillment.

Args:

fulfillmentId: Fulfillment ID
trackingInfo: New tracking information
- number: Tracking number
- url: Tracking URL
- company: Shipping company
notifyCustomer: Whether to notify customer of update

Returns: The updated fulfillment.

{
  "type": "object",
  "required": [
    "fulfillmentId"
  ],
  "properties": {
    "fulfillmentId": {
      "type": "number",
      "description": "Fulfillment ID"
    },
    "notifyCustomer": {
      "type": "boolean"
    }
  }
}

shopify_cancel_fulfillment

Cancel a fulfillment.

Args:

fulfillmentId: Fulfillment ID to cancel

Returns: The cancelled fulfillment.

{
  "type": "object",
  "required": [
    "fulfillmentId"
  ],
  "properties": {
    "fulfillmentId": {
      "type": "number",
      "description": "Fulfillment ID"
    }
  }
}

shopify_list_fulfillment_orders

List fulfillment orders for an order.

Fulfillment orders represent groups of items to be fulfilled together.

Args:

orderId: Order ID
format: Response format

Returns: List of fulfillment orders with their line items.

{
  "type": "object",
  "required": [
    "orderId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "orderId": {
      "type": "number",
      "description": "Order ID"
    }
  }
}

shopify_get_location_count

Get the count of locations.

Returns: Count of locations.

{
  "type": "object",
  "properties": {}
}

shopify_list_inventory_levels

List inventory levels for items at locations.

You must provide at least one of: locationIds or inventoryItemIds.

Args:

locationIds: Comma-separated location IDs
inventoryItemIds: Comma-separated inventory item IDs
limit: Number of levels to return

Returns: List of inventory levels with available quantities.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 250,
      "minimum": 1
    },
    "locationIds": {
      "type": "string",
      "description": "Comma-separated location IDs"
    },
    "inventoryItemIds": {
      "type": "string",
      "description": "Comma-separated inventory item IDs"
    }
  }
}

shopify_adjust_inventory_level

Adjust the inventory level by a relative amount.

Use this to increment or decrement inventory (e.g., +5 or -3).

Args:

inventoryItemId: Inventory item ID
locationId: Location ID
adjustment: Amount to adjust (positive or negative)

Returns: The updated inventory level.

{
  "type": "object",
  "required": [
    "inventoryItemId",
    "locationId",
    "adjustment"
  ],
  "properties": {
    "adjustment": {
      "type": "number",
      "description": "Adjustment amount (positive or negative)"
    },
    "locationId": {
      "type": "number",
      "description": "Location ID"
    },
    "inventoryItemId": {
      "type": "number",
      "description": "Inventory item ID"
    }
  }
}

shopify_set_inventory_level

Set the inventory level to an absolute value.

Use this to set inventory to a specific number (e.g., set to 100).

Args:

inventoryItemId: Inventory item ID
locationId: Location ID
available: New available quantity

Returns: The updated inventory level.

{
  "type": "object",
  "required": [
    "inventoryItemId",
    "locationId",
    "available"
  ],
  "properties": {
    "available": {
      "type": "number",
      "description": "New available quantity"
    },
    "locationId": {
      "type": "number",
      "description": "Location ID"
    },
    "inventoryItemId": {
      "type": "number",
      "description": "Inventory item ID"
    }
  }
}

shopify_get_inventory_item

Get an inventory item by ID.

Inventory items are connected to product variants.

Args:

inventoryItemId: Inventory item ID
format: Response format

Returns: The inventory item details including SKU, cost, tracking settings.

{
  "type": "object",
  "required": [
    "inventoryItemId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "inventoryItemId": {
      "type": "number",
      "description": "Inventory item ID"
    }
  }
}

shopify_update_inventory_item

Update an inventory item.

Args:

inventoryItemId: Inventory item ID
sku: New SKU
cost: New cost
tracked: Whether to track inventory
countryCodeOfOrigin: Country of origin (ISO 3166-1 alpha-2)
provinceCodeOfOrigin: Province of origin
harmonizedSystemCode: HS tariff code

Returns: The updated inventory item.

{
  "type": "object",
  "required": [
    "inventoryItemId"
  ],
  "properties": {
    "sku": {
      "type": "string"
    },
    "cost": {
      "type": "string"
    },
    "tracked": {
      "type": "boolean"
    },
    "inventoryItemId": {
      "type": "number",
      "description": "Inventory item ID"
    },
    "countryCodeOfOrigin": {
      "type": "string"
    },
    "harmonizedSystemCode": {
      "type": "string"
    },
    "provinceCodeOfOrigin": {
      "type": "string"
    }
  }
}

shopify_list_metafields

List metafields for a resource.

Metafields store custom data for products, customers, orders, etc.

Args:

ownerResource: Resource type (products, customers, orders, collections, etc.)
ownerId: Resource ID
limit: Number of metafields to return
namespace: Filter by namespace
key: Filter by key
format: Response format

Returns: Paginated list of metafields.

{
  "type": "object",
  "required": [
    "ownerResource",
    "ownerId"
  ],
  "properties": {
    "key": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 250,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "ownerId": {
      "type": "number",
      "description": "Resource ID"
    },
    "namespace": {
      "type": "string"
    },
    "ownerResource": {
      "type": "string",
      "description": "Resource type (e.g., \"products"
    }
  }
}

shopify_get_metafield

Get a single metafield by ID.

Args:

ownerResource: Resource type
ownerId: Resource ID
metafieldId: Metafield ID
format: Response format

Returns: The metafield details.

{
  "type": "object",
  "required": [
    "ownerResource",
    "ownerId",
    "metafieldId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "ownerId": {
      "type": "number",
      "description": "Resource ID"
    },
    "metafieldId": {
      "type": "number",
      "description": "Metafield ID"
    },
    "ownerResource": {
      "type": "string",
      "description": "Resource type"
    }
  }
}

shopify_create_metafield

Create a metafield for a resource.

Common types:

single_line_text_field, multi_line_text_field
number_integer, number_decimal
boolean
json
date, date_time
color, url, rating
dimension, weight, volume
product_reference, variant_reference, collection_reference
file_reference

Args:

ownerResource: Resource type (products, customers, orders, etc.)
ownerId: Resource ID
namespace: Metafield namespace (required)
key: Metafield key (required)
value: Metafield value (required)
type: Metafield type (required)
description: Description

Returns: The created metafield.

{
  "type": "object",
  "required": [
    "ownerResource",
    "ownerId",
    "namespace",
    "key",
    "value",
    "type"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "Metafield key"
    },
    "type": {
      "type": "string",
      "description": "Metafield type"
    },
    "value": {
      "type": "string",
      "description": "Metafield value"
    },
    "ownerId": {
      "type": "number",
      "description": "Resource ID"
    },
    "namespace": {
      "type": "string",
      "description": "Metafield namespace"
    },
    "description": {
      "type": "string"
    },
    "ownerResource": {
      "type": "string",
      "description": "Resource type"
    }
  }
}

shopify_get_asset

Get a single asset from a theme.

Returns the asset content (value) and metadata.

Args:

themeId: Theme ID
key: Asset key (file path, e.g., "templates/index.liquid")
format: Response format

Returns: The asset with its content.

{
  "type": "object",
  "required": [
    "themeId",
    "key"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "Asset key (file path)"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "themeId": {
      "type": "number",
      "description": "Theme ID"
    }
  }
}

shopify_update_metafield

Update an existing metafield.

Args:

ownerResource: Resource type
ownerId: Resource ID
metafieldId: Metafield ID
value: New value
type: New type (optional)

Returns: The updated metafield.

{
  "type": "object",
  "required": [
    "ownerResource",
    "ownerId",
    "metafieldId",
    "value"
  ],
  "properties": {
    "type": {
      "type": "string"
    },
    "value": {
      "type": "string",
      "description": "New value"
    },
    "ownerId": {
      "type": "number",
      "description": "Resource ID"
    },
    "metafieldId": {
      "type": "number",
      "description": "Metafield ID"
    },
    "ownerResource": {
      "type": "string",
      "description": "Resource type"
    }
  }
}

shopify_delete_metafield

Delete a metafield.

Args:

ownerResource: Resource type
ownerId: Resource ID
metafieldId: Metafield ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "ownerResource",
    "ownerId",
    "metafieldId"
  ],
  "properties": {
    "ownerId": {
      "type": "number",
      "description": "Resource ID"
    },
    "metafieldId": {
      "type": "number",
      "description": "Metafield ID"
    },
    "ownerResource": {
      "type": "string",
      "description": "Resource type"
    }
  }
}

shopify_list_shop_metafields

List metafields attached to the shop itself.

Args:

limit: Number of metafields to return
namespace: Filter by namespace
key: Filter by key
format: Response format

Returns: Paginated list of shop metafields.

{
  "type": "object",
  "properties": {
    "key": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 250,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "namespace": {
      "type": "string"
    }
  }
}

shopify_create_shop_metafield

Create a metafield for the shop.

Args:

namespace: Metafield namespace (required)
key: Metafield key (required)
value: Metafield value (required)
type: Metafield type (required)
description: Description

Returns: The created shop metafield.

{
  "type": "object",
  "required": [
    "namespace",
    "key",
    "value",
    "type"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "Metafield key"
    },
    "type": {
      "type": "string",
      "description": "Metafield type"
    },
    "value": {
      "type": "string",
      "description": "Metafield value"
    },
    "namespace": {
      "type": "string",
      "description": "Metafield namespace"
    },
    "description": {
      "type": "string"
    }
  }
}

shopify_list_orders

List orders from the store with pagination and filters.

Args:

limit: Number of orders to return (1-250, default: 50)
sinceId: Return orders after this ID
status: Order status (open, closed, cancelled, any)
financialStatus: Financial status (authorized, pending, paid, partially_paid, refunded, voided, partially_refunded, any, unpaid)
fulfillmentStatus: Fulfillment status (shipped, partial, unshipped, any, unfulfilled)
createdAtMin: Minimum created date (ISO 8601)
createdAtMax: Maximum created date (ISO 8601)
updatedAtMin: Minimum updated date
updatedAtMax: Maximum updated date
processedAtMin: Minimum processed date
processedAtMax: Maximum processed date
ids: Comma-separated list of order IDs
format: Response format

Returns: Paginated list of orders.

{
  "type": "object",
  "properties": {
    "ids": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 250,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "status": {
      "enum": [
        "open",
        "closed",
        "cancelled",
        "any"
      ],
      "type": "string"
    },
    "sinceId": {
      "type": "string"
    },
    "createdAtMax": {
      "type": "string"
    },
    "createdAtMin": {
      "type": "string"
    },
    "updatedAtMax": {
      "type": "string"
    },
    "updatedAtMin": {
      "type": "string"
    },
    "processedAtMax": {
      "type": "string"
    },
    "processedAtMin": {
      "type": "string"
    }
  }
}

shopify_get_order

Get a single order by ID.

Args:

orderId: The order ID
format: Response format

Returns: The order with all details including line items, shipping, etc.

{
  "type": "object",
  "required": [
    "orderId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "orderId": {
      "type": "number",
      "description": "Order ID"
    }
  }
}

shopify_create_order

Create a new order (typically for importing historical orders).

Args:

lineItems: Array of line items (required)
- variantId: Variant ID
- title: Product title
- quantity: Quantity
- price: Price
customer: Customer object (id or email)
billingAddress: Billing address object
shippingAddress: Shipping address object
email: Customer email
financialStatus: Financial status
fulfillmentStatus: Fulfillment status
note: Order note
tags: Comma-separated tags
sendReceipt: Whether to send receipt email
sendFulfillmentReceipt: Whether to send fulfillment email

Returns: The created order.

{
  "type": "object",
  "properties": {
    "note": {
      "type": "string"
    },
    "tags": {
      "type": "string"
    },
    "email": {
      "type": "string"
    },
    "customer": {
      "type": "object"
    },
    "sendReceipt": {
      "type": "boolean"
    },
    "financialStatus": {
      "type": "string"
    },
    "fulfillmentStatus": {
      "type": "string"
    },
    "sendFulfillmentReceipt": {
      "type": "boolean"
    }
  }
}

shopify_update_order

Update an existing order.

Args:

orderId: Order ID to update
email: New email
phone: New phone
note: New note
tags: New tags
shippingAddress: New shipping address
buyer_accepts_marketing: Marketing consent

Returns: The updated order.

{
  "type": "object",
  "required": [
    "orderId"
  ],
  "properties": {
    "note": {
      "type": "string"
    },
    "tags": {
      "type": "string"
    },
    "email": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "orderId": {
      "type": "number",
      "description": "Order ID"
    },
    "buyerAcceptsMarketing": {
      "type": "boolean"
    }
  }
}

shopify_delete_order

Delete an order (moves to trash, can be restored within 60 days).

Args:

orderId: Order ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "orderId"
  ],
  "properties": {
    "orderId": {
      "type": "number",
      "description": "Order ID"
    }
  }
}

shopify_get_order_count

Get the count of orders matching filters.

Args:

status: Order status filter
financialStatus: Financial status filter
fulfillmentStatus: Fulfillment status filter
createdAtMin: Minimum created date
createdAtMax: Maximum created date

Returns: Count of matching orders.

{
  "type": "object",
  "properties": {
    "status": {
      "enum": [
        "open",
        "closed",
        "cancelled",
        "any"
      ],
      "type": "string"
    },
    "createdAtMax": {
      "type": "string"
    },
    "createdAtMin": {
      "type": "string"
    }
  }
}

shopify_close_order

Close an order (marks as archived).

Args:

orderId: Order ID to close

Returns: The closed order.

{
  "type": "object",
  "required": [
    "orderId"
  ],
  "properties": {
    "orderId": {
      "type": "number",
      "description": "Order ID"
    }
  }
}

shopify_cancel_order

Cancel an order.

Args:

orderId: Order ID to cancel
reason: Cancellation reason (customer, fraud, inventory, declined, other)
email: Send cancellation email to customer
restock: Restock inventory

Returns: The cancelled order.

{
  "type": "object",
  "required": [
    "orderId"
  ],
  "properties": {
    "email": {
      "type": "boolean",
      "description": "Send cancellation email"
    },
    "reason": {
      "enum": [
        "customer",
        "fraud",
        "inventory",
        "declined",
        "other"
      ],
      "type": "string"
    },
    "orderId": {
      "type": "number",
      "description": "Order ID"
    },
    "restock": {
      "type": "boolean",
      "description": "Restock inventory"
    }
  }
}

shopify_list_products

List products from the Shopify store with pagination and filters.

Args:

limit: Number of products to return (1-250, default: 50)
sinceId: Return products after this ID
title: Filter by title
vendor: Filter by vendor
handle: Filter by handle
productType: Filter by product type
collectionId: Filter by collection
status: Filter by status (active, archived, draft)
publishedStatus: Filter by published status
format: Response format ('json' or 'markdown')

Returns: Paginated list of products with variants.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 250,
      "minimum": 1,
      "description": "Number of products to return"
    },
    "title": {
      "type": "string",
      "description": "Filter by title"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "handle": {
      "type": "string",
      "description": "Filter by handle"
    },
    "status": {
      "enum": [
        "active",
        "archived",
        "draft"
      ],
      "type": "string",
      "description": "Filter by status"
    },
    "vendor": {
      "type": "string",
      "description": "Filter by vendor"
    },
    "sinceId": {
      "type": "string",
      "description": "Return products after this ID"
    },
    "productType": {
      "type": "string",
      "description": "Filter by product type"
    },
    "collectionId": {
      "type": "string",
      "description": "Filter by collection ID"
    }
  }
}

shopify_get_product

Get a single product by ID.

Args:

productId: The product ID
format: Response format ('json' or 'markdown')

Returns: The product with all variants and images.

{
  "type": "object",
  "required": [
    "productId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "productId": {
      "type": "number",
      "description": "Product ID"
    }
  }
}

shopify_create_product

Create a new product in the store.

Args:

title: Product title (required)
bodyHtml: Product description in HTML
vendor: Product vendor
productType: Product type
tags: Comma-separated tags
status: Product status (active, archived, draft)
variants: Array of variant objects with price, sku, etc.
options: Array of option objects (name, values)
images: Array of image objects (src, alt)

Returns: The created product.

{
  "type": "object",
  "required": [
    "title"
  ],
  "properties": {
    "tags": {
      "type": "string",
      "description": "Comma-separated tags"
    },
    "title": {
      "type": "string",
      "description": "Product title (required)"
    },
    "status": {
      "enum": [
        "active",
        "archived",
        "draft"
      ],
      "type": "string",
      "description": "Product status"
    },
    "vendor": {
      "type": "string",
      "description": "Product vendor"
    },
    "bodyHtml": {
      "type": "string",
      "description": "Product description in HTML"
    },
    "productType": {
      "type": "string",
      "description": "Product type"
    }
  }
}

shopify_update_product

Update an existing product.

Args:

productId: Product ID to update
title: New product title
bodyHtml: New product description
vendor: New vendor
productType: New product type
tags: New comma-separated tags
status: New status

Returns: The updated product.

{
  "type": "object",
  "required": [
    "productId"
  ],
  "properties": {
    "tags": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "status": {
      "enum": [
        "active",
        "archived",
        "draft"
      ],
      "type": "string"
    },
    "vendor": {
      "type": "string"
    },
    "bodyHtml": {
      "type": "string"
    },
    "productId": {
      "type": "number",
      "description": "Product ID to update"
    },
    "productType": {
      "type": "string"
    }
  }
}

shopify_delete_product

Delete a product from the store.

Args:

productId: Product ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "productId"
  ],
  "properties": {
    "productId": {
      "type": "number",
      "description": "Product ID to delete"
    }
  }
}

shopify_get_product_count

Get the count of products matching filters.

Args:

vendor: Filter by vendor
productType: Filter by product type
collectionId: Filter by collection
status: Filter by status

Returns: Count of matching products.

{
  "type": "object",
  "properties": {
    "status": {
      "enum": [
        "active",
        "archived",
        "draft"
      ],
      "type": "string"
    },
    "vendor": {
      "type": "string"
    },
    "productType": {
      "type": "string"
    },
    "collectionId": {
      "type": "string"
    }
  }
}

shopify_list_product_variants

List all variants for a product.

Args:

productId: Product ID
limit: Number of variants to return
format: Response format

Returns: List of product variants.

{
  "type": "object",
  "required": [
    "productId"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 250,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "productId": {
      "type": "number",
      "description": "Product ID"
    }
  }
}

shopify_get_variant

Get a single product variant by ID.

Args:

variantId: Variant ID
format: Response format

Returns: The variant details.

{
  "type": "object",
  "required": [
    "variantId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "variantId": {
      "type": "number",
      "description": "Variant ID"
    }
  }
}

shopify_create_variant

Create a new variant for a product.

Args:

productId: Product ID
price: Variant price
sku: SKU code
option1: First option value
option2: Second option value
option3: Third option value
barcode: Barcode
weight: Weight
weightUnit: Weight unit (g, kg, lb, oz)
inventoryQuantity: Initial inventory quantity

Returns: The created variant.

{
  "type": "object",
  "required": [
    "productId"
  ],
  "properties": {
    "sku": {
      "type": "string"
    },
    "price": {
      "type": "string"
    },
    "weight": {
      "type": "number"
    },
    "barcode": {
      "type": "string"
    },
    "option1": {
      "type": "string"
    },
    "option2": {
      "type": "string"
    },
    "option3": {
      "type": "string"
    },
    "productId": {
      "type": "number",
      "description": "Product ID"
    },
    "weightUnit": {
      "enum": [
        "g",
        "kg",
        "lb",
        "oz"
      ],
      "type": "string"
    },
    "inventoryQuantity": {
      "type": "number"
    }
  }
}

shopify_update_variant

Update an existing variant.

Args:

variantId: Variant ID to update
price: New price
sku: New SKU
option1/2/3: New option values
barcode: New barcode
weight: New weight
compareAtPrice: Compare at price

Returns: The updated variant.

{
  "type": "object",
  "required": [
    "variantId"
  ],
  "properties": {
    "sku": {
      "type": "string"
    },
    "price": {
      "type": "string"
    },
    "weight": {
      "type": "number"
    },
    "barcode": {
      "type": "string"
    },
    "option1": {
      "type": "string"
    },
    "option2": {
      "type": "string"
    },
    "option3": {
      "type": "string"
    },
    "variantId": {
      "type": "number",
      "description": "Variant ID"
    },
    "compareAtPrice": {
      "type": "string"
    }
  }
}

shopify_delete_variant

Delete a product variant.

Args:

productId: Product ID
variantId: Variant ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "productId",
    "variantId"
  ],
  "properties": {
    "productId": {
      "type": "number",
      "description": "Product ID"
    },
    "variantId": {
      "type": "number",
      "description": "Variant ID"
    }
  }
}

shopify_list_product_images

List all images for a product.

Args:

productId: Product ID
limit: Number of images to return
format: Response format

Returns: List of product images.

{
  "type": "object",
  "required": [
    "productId"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 250,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "productId": {
      "type": "number",
      "description": "Product ID"
    }
  }
}

shopify_create_product_image

Create a new image for a product.

Args:

productId: Product ID
src: Image URL (required unless using attachment)
attachment: Base64-encoded image data
alt: Alt text for the image
position: Position in the image list
variantIds: Array of variant IDs to associate

Returns: The created image.

{
  "type": "object",
  "required": [
    "productId"
  ],
  "properties": {
    "alt": {
      "type": "string",
      "description": "Alt text"
    },
    "src": {
      "type": "string",
      "description": "Image URL"
    },
    "position": {
      "type": "number",
      "description": "Position"
    },
    "productId": {
      "type": "number",
      "description": "Product ID"
    },
    "attachment": {
      "type": "string",
      "description": "Base64-encoded image"
    },
    "variantIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Variant IDs to associate"
    }
  }
}

shopify_update_product_image

Update an existing product image.

Args:

productId: Product ID
imageId: Image ID
alt: New alt text
position: New position
variantIds: New variant IDs to associate

Returns: The updated image.

{
  "type": "object",
  "required": [
    "productId",
    "imageId"
  ],
  "properties": {
    "alt": {
      "type": "string"
    },
    "imageId": {
      "type": "number",
      "description": "Image ID"
    },
    "position": {
      "type": "number"
    },
    "productId": {
      "type": "number",
      "description": "Product ID"
    },
    "variantIds": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  }
}

shopify_delete_product_image

Delete a product image.

Args:

productId: Product ID
imageId: Image ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "productId",
    "imageId"
  ],
  "properties": {
    "imageId": {
      "type": "number",
      "description": "Image ID"
    },
    "productId": {
      "type": "number",
      "description": "Product ID"
    }
  }
}

shopify_test_connection

Test the connection to the Shopify store.

Verifies that the API credentials are valid and returns shop information.

Returns: Connection status and shop name if successful.

{
  "type": "object",
  "properties": {}
}

shopify_get_shop

Get shop details and configuration.

Returns comprehensive information about the Shopify store including:

Shop name, email, and owner info
Address and timezone
Currency and money format settings
Plan information
Feature flags

Args:

format: Response format ('json' or 'markdown')

Returns: Complete shop configuration object.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

shopify_list_themes

List all themes in the store.

Returns themes with their roles (main, unpublished, demo).

Args:

format: Response format

Returns: List of themes.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

shopify_get_theme

Get a single theme by ID.

Args:

themeId: Theme ID
format: Response format

Returns: The theme details.

{
  "type": "object",
  "required": [
    "themeId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "themeId": {
      "type": "number",
      "description": "Theme ID"
    }
  }
}

shopify_create_theme

Create a new theme.

Args:

name: Theme name (required)
src: URL to a ZIP file containing the theme (optional)
role: Theme role (main, unpublished)

Returns: The created theme.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "src": {
      "type": "string",
      "description": "URL to theme ZIP file"
    },
    "name": {
      "type": "string",
      "description": "Theme name"
    },
    "role": {
      "enum": [
        "main",
        "unpublished"
      ],
      "type": "string"
    }
  }
}

shopify_update_theme

Update an existing theme.

Args:

themeId: Theme ID to update
name: New theme name
role: New theme role (main to publish, unpublished to unpublish)

Returns: The updated theme.

{
  "type": "object",
  "required": [
    "themeId"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "role": {
      "enum": [
        "main",
        "unpublished"
      ],
      "type": "string"
    },
    "themeId": {
      "type": "number",
      "description": "Theme ID"
    }
  }
}

shopify_delete_theme

Delete a theme.

Note: The main (published) theme cannot be deleted.

Args:

themeId: Theme ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "themeId"
  ],
  "properties": {
    "themeId": {
      "type": "number",
      "description": "Theme ID"
    }
  }
}

shopify_list_assets

List all assets in a theme.

Returns a list of asset keys (file paths) in the theme.

Args:

themeId: Theme ID
format: Response format

Returns: List of asset keys.

{
  "type": "object",
  "required": [
    "themeId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "themeId": {
      "type": "number",
      "description": "Theme ID"
    }
  }
}

shopify_create_or_update_asset

Create or update a theme asset.

Use value for text content or attachment for binary content.

Args:

themeId: Theme ID
key: Asset key (file path, e.g., "templates/custom.liquid")
value: Asset content as text
attachment: Asset content as base64-encoded string
sourceKey: Copy from another asset key (instead of value/attachment)

Returns: The created/updated asset.

{
  "type": "object",
  "required": [
    "themeId",
    "key"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "Asset key (file path)"
    },
    "value": {
      "type": "string",
      "description": "Text content"
    },
    "themeId": {
      "type": "number",
      "description": "Theme ID"
    },
    "sourceKey": {
      "type": "string",
      "description": "Copy from this asset key"
    },
    "attachment": {
      "type": "string",
      "description": "Base64-encoded binary content"
    }
  }
}

shopify_delete_asset

Delete an asset from a theme.

Args:

themeId: Theme ID
key: Asset key to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "themeId",
    "key"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "Asset key"
    },
    "themeId": {
      "type": "number",
      "description": "Theme ID"
    }
  }
}

shopify_list_transactions

List all transactions for an order.

Transactions represent payments, refunds, and other monetary operations.

Args:

orderId: Order ID
format: Response format

Returns: List of transactions.

{
  "type": "object",
  "required": [
    "orderId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "orderId": {
      "type": "number",
      "description": "Order ID"
    }
  }
}

shopify_get_transaction

Get a single transaction by ID.

Args:

orderId: Order ID
transactionId: Transaction ID
format: Response format

Returns: The transaction details.

{
  "type": "object",
  "required": [
    "orderId",
    "transactionId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "orderId": {
      "type": "number",
      "description": "Order ID"
    },
    "transactionId": {
      "type": "number",
      "description": "Transaction ID"
    }
  }
}

shopify_create_transaction

Create a transaction for an order.

Use this to capture authorized payments or record external payments.

Args:

orderId: Order ID
kind: Transaction kind (authorization, capture, sale, void, refund)
amount: Transaction amount
currency: Currency code (optional)
parentId: Parent transaction ID (for captures/refunds)
gateway: Payment gateway used

Returns: The created transaction.

{
  "type": "object",
  "required": [
    "orderId"
  ],
  "properties": {
    "amount": {
      "type": "string",
      "description": "Transaction amount"
    },
    "gateway": {
      "type": "string",
      "description": "Payment gateway"
    },
    "orderId": {
      "type": "number",
      "description": "Order ID"
    },
    "currency": {
      "type": "string",
      "description": "Currency code"
    },
    "parentId": {
      "type": "number",
      "description": "Parent transaction ID"
    }
  }
}

shopify_list_refunds

List all refunds for an order.

Args:

orderId: Order ID
format: Response format

Returns: List of refunds with line items and amounts.

{
  "type": "object",
  "required": [
    "orderId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "orderId": {
      "type": "number",
      "description": "Order ID"
    }
  }
}

shopify_get_refund

Get a single refund by ID.

Args:

orderId: Order ID
refundId: Refund ID
format: Response format

Returns: The refund details.

{
  "type": "object",
  "required": [
    "orderId",
    "refundId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "orderId": {
      "type": "number",
      "description": "Order ID"
    },
    "refundId": {
      "type": "number",
      "description": "Refund ID"
    }
  }
}

shopify_calculate_refund

Calculate the refund amounts before creating a refund.

Use this to preview what a refund would look like.

Args:

orderId: Order ID
refundLineItems: Array of line items to refund
- lineItemId: Line item ID
- quantity: Quantity to refund
- restockType: How to handle inventory (no_restock, cancel, return)
shipping: Shipping refund object
- fullRefund: Whether to fully refund shipping
- amount: Specific amount to refund

Returns: Calculated refund amounts.

{
  "type": "object",
  "properties": {
    "orderId": {
      "type": "number",
      "description": "Order ID"
    }
  }
}

shopify_create_refund

Create a refund for an order.

Args:

orderId: Order ID
refundLineItems: Array of line items to refund
- lineItemId: Line item ID
- quantity: Quantity to refund
- restockType: How to handle inventory (no_restock, cancel, return)
shipping: Shipping refund object
- fullRefund: Whether to fully refund shipping
- amount: Specific amount to refund
notify: Whether to send refund notification to customer
note: Refund note
transactions: Refund transaction details
- parentId: Parent transaction ID
- amount: Amount to refund
- kind: Transaction kind (usually 'refund')
- gateway: Payment gateway

Returns: The created refund.

{
  "type": "object",
  "properties": {
    "note": {
      "type": "string"
    },
    "notify": {
      "type": "boolean",
      "default": true
    },
    "orderId": {
      "type": "number",
      "description": "Order ID"
    }
  }
}

shopify_list_webhooks

List webhooks with pagination and filters.

Webhooks send notifications to your app when events occur in the store.

Args:

limit: Number of webhooks to return (1-250, default: 50)
sinceId: Return webhooks after this ID
topic: Filter by topic (e.g., orders/create)
address: Filter by endpoint URL
format: Response format

Returns: Paginated list of webhooks.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 250,
      "minimum": 1
    },
    "topic": {
      "type": "string"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "address": {
      "type": "string"
    },
    "sinceId": {
      "type": "string"
    }
  }
}

shopify_get_webhook

Get a single webhook by ID.

Args:

webhookId: Webhook ID
format: Response format

Returns: The webhook details.

{
  "type": "object",
  "required": [
    "webhookId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "webhookId": {
      "type": "number",
      "description": "Webhook ID"
    }
  }
}

shopify_create_webhook

Create a new webhook subscription.

Common topics:

orders/create, orders/updated, orders/paid, orders/cancelled, orders/fulfilled
products/create, products/update, products/delete
customers/create, customers/update, customers/delete
inventory_levels/update, inventory_levels/connect, inventory_levels/disconnect
fulfillments/create, fulfillments/update
carts/create, carts/update
checkouts/create, checkouts/update
app/uninstalled, shop/update

Args:

topic: Event topic (required, e.g., "orders/create")
address: Callback URL (required, must be HTTPS)
format: Payload format (json or xml)
fields: Specific fields to include in payload
metafieldNamespaces: Metafield namespaces to include

Returns: The created webhook.

{
  "type": "object",
  "required": [
    "topic",
    "address"
  ],
  "properties": {
    "topic": {
      "type": "string",
      "description": "Event topic (e.g., \"orders/create"
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "format": {
      "enum": [
        "json",
        "xml"
      ],
      "type": "string",
      "default": "json"
    },
    "address": {
      "type": "string",
      "description": "Callback URL (HTTPS required)"
    },
    "metafieldNamespaces": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}

shopify_update_webhook

Update an existing webhook.

Args:

webhookId: Webhook ID to update
address: New callback URL
topic: New topic
format: New payload format
fields: New fields to include
metafieldNamespaces: New metafield namespaces

Returns: The updated webhook.

{
  "type": "object",
  "required": [
    "webhookId"
  ],
  "properties": {
    "topic": {
      "type": "string"
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "format": {
      "enum": [
        "json",
        "xml"
      ],
      "type": "string"
    },
    "address": {
      "type": "string"
    },
    "webhookId": {
      "type": "number",
      "description": "Webhook ID"
    },
    "metafieldNamespaces": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}

shopify_delete_webhook

Delete a webhook subscription.

Args:

webhookId: Webhook ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "webhookId"
  ],
  "properties": {
    "webhookId": {
      "type": "number",
      "description": "Webhook ID"
    }
  }
}

shopify_get_webhook_count

Get the count of webhooks matching filters.

Args:

topic: Filter by topic
address: Filter by address

Returns: Count of matching webhooks.

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string"
    },
    "address": {
      "type": "string"
    }
  }
}