- Home
- Resources
- Integrations
- Commerce Layer Metrics
Claude Commerce Layer Metrics connectorWhat Claude can do in your Commerce Layer Metrics account.
The Claude Commerce Layer Metrics connector exposes 33 tools: 33 for reading, 0 for writing. It is a desktop extension that queries the Metrics API on your order, cart and return history. Below: what Claude can measure, what it never touches, and the credentials it needs.
Verified Trustpilot reviews · AI, automation & growth agency
What changes for an e-commerce team that lives in dashboards
Answering a question like which products sell best in each market usually means building a query or waiting for an analyst. With this extension in Claude Desktop, you ask in plain words and Claude picks among 33 metrics tools, runs the right aggregation on your Commerce Layer data and explains the result.
Four kinds of query on three resources. Orders, carts and returns each get a breakdown, a date breakdown, stats and a search, such as orders-breakdown or returns-search, so Claude can slice your history in whichever way the question needs.
Ready answers to common questions. Twenty tools package frequent scenarios: best-selling-products-by-market, orders-paid-with-gift-cards, shipments-average-time-in-picking and more, so you skip writing filters.
Basket analysis. fbt and frequently-bought-together-products look across the whole order history for the items most often bought together.
What it does not do: by default its sheet exposes reading only. No tool on the sheet places, edits or cancels an order, and none touches a price or a promotion. It also does not watch your store; no report goes out when a threshold is crossed. Scheduled reporting of that kind belongs to automation tools, reachable from the Integrations hub.
Five words before you plug it in
The vocabulary you will meet in Claude Desktop.
- Connector
- The link you set up once between Claude and an account you already run, so Claude can query it while it answers you.
- Tool
- One named action the connector offers Claude. Claude chooses which to call by itself; the directory sheet lists every one by name.
- Authorization
- The access you grant so Claude can reach the account. Here it takes the shape of a Commerce Layer client ID and client secret.
- Approval
- The confirmation Claude waits for in the chat before going through with an action that changes an account on your behalf.
- MCP
- The shared standard behind connectors: it is what lets an assistant like Claude talk to an outside service in the first place.
Plug Commerce Layer Metrics into Claude in three steps
- 01
Start in Claude Desktop
This is a desktop extension, so open Claude Desktop, then Customize and Connectors, and find Commerce Layer Metrics. On a Team or Enterprise workspace, an Owner or Primary Owner enables it before members can use it.
- 02
Install and connect
Click Connect on its row. The repository behind it also describes installing it as a packed extension bundle in Claude Desktop. If the link breaks later, Disconnect it and connect again.
- 03
Enter scoped credentials
When asked, enter a client ID and client secret from your Commerce Layer organisation. Those values decide what the extension can read, and the repository asks for them at install.
The 33 tools, sorted by what they do
Commerce Layer Metrics gives Claude 33 tools: 33 that read your account, 0 that change something in it.
All thirty-three read. Names stay in English, as Claude shows them, in the order of the directory sheet.
- 33 read
Tools index
- orders-breakdown
- orders-date-breakdown
- orders-search
- orders-stats
- carts-breakdown
- carts-date-breakdown
- carts-search
- carts-stats
- returns-breakdown
- returns-date-breakdown
- returns-search
- returns-stats
- fbt
- best-selling-products-by-market
- customers_that_bought_a_specific_product
- frequently-bought-together-products
- last-carts-with-a-specific-product-from-a-specific-market
- latest-archived-orders
- latest-placed-orders-from-customers-with-specific-email-domains
- number-of-products-per-order-by-country
- orders-associated-with-a-specific-promotion
- orders-by-bundle
- orders-by-currency
- orders-by-day
- orders-by-repeat-customer
- orders-by-resource-error-code-and-message
- orders-by-shipment-status-and-shipping-method-name
- orders-by-status-and-payment-status
- orders-paid-with-gift-cards
- refunds-by-country-and-currency
- returns-per-year-by-destination-city
- shipments-average-time-in-picking
- top-10-spenders-by-currency
What Claude reads (33)
33 toolsThirty-three tools that query, aggregate or search your order, cart and return history.
orders-breakdown
Aggregates your orders by one field and computes a metric on another, using the operator you choose. Commerce Layer describes breakdowns as aggregations computed on field values, here on order records.
orders-date-breakdown
Spreads order data over a time interval and applies an operator per date, so Claude can show how a value evolves day by day or month by month.
orders-search
Returns actual order records matching your filters, with the fields you ask for, sorted and paginated, rather than an aggregate.
orders-stats
Computes a single figure over one field of your orders, with the operator you pick. Commerce Layer calls stats numeric computations over values pulled from one field, here a field of your orders.
carts-breakdown
Groups carts by one attribute and measures another. It is the breakdown aggregation of the Metrics API, applied to cart records instead of orders.
carts-date-breakdown
Lays cart data out along dates and applies an operator to each day or period, so trends in basket creation become visible.
carts-search
Lists real cart records that match your criteria, with chosen fields, ordering and pagination, so you look at individual baskets rather than totals.
carts-stats
Produces one number on a cart field, according to the operator selected. The result is a numeric computation over values extracted from that single cart field.
returns-breakdown
Summarises returns by one field and calculates a metric on another, a quick way to see which segment generates the most returned value. The answer comes back as metrics or statistics computed on the values of return records.
returns-date-breakdown
Places return data on a timeline and applies the chosen operator per date, so seasonal peaks in returns stand out. For each date, the operator runs over a selected field of the returns present on that date.
returns-search
Pulls the individual return records that fit your filters, with the fields you need, sorted and split into pages.
returns-stats
Calculates a single statistic across a return field, using the operator you set. The computation runs over values extracted from one field of your return records.
fbt
Runs the Metrics API analysis that, across your entire order history, finds the items most often added to the same orders as a given SKU, bundle or set of items.
best-selling-products-by-market
Gives the top N best-selling products for each market of your organisation in one pass, without you building the grouping. The ranking is computed separately for each market of the organisation.
customers_that_bought_a_specific_product
Counts the customers who purchased a specific product or bundle, a fast measure of reach for one item.
frequently-bought-together-products
Lists the products most frequently purchased alongside other ones, a ready view of natural pairings in your catalogue. The answer is a ranking of products drawn from what your customers actually bought together.
last-carts-with-a-specific-product-from-a-specific-market
Fetches the most recently created carts that contain a given SKU, limited to one market of your choice. Both filters apply at once, the SKU and the market you name, newest carts first.
latest-archived-orders
Brings back the orders most recently archived, handy to check what was set aside and when. The list starts from the order archived most recently.
latest-placed-orders-from-customers-with-specific-email-domains
Finds the last placed orders whose details contain specific email domains, which isolates purchases from given companies or partners. The match is made on the email domains found in the aggregated order details.
number-of-products-per-order-by-country
Provides mixed statistics on how many SKUs each order contains, grouped by country, so basket size can be compared across borders. The figures are mixed statistics on the number of SKUs per order, one set per country.
orders-associated-with-a-specific-promotion
Counts the orders that triggered a specific promotion, a direct read of how far a discount actually went. You name the promotion, and the answer is a single total of orders.
orders-by-bundle
Totals the orders that include a bundle, grouped by bundle name, so you see which packs customers really choose. Each bundle name gets its own line with its own order total.
orders-by-currency
Tallies your organisation's orders split by currency, a quick picture of where the money comes in. Each currency your organisation sells in gets its own order total.
orders-by-day
Counts orders grouped by day, the simplest daily curve of activity for the whole organisation. Each day gets its own total of orders across the whole organisation.
orders-by-repeat-customer
Totals orders grouped by customers who bought from you more than once, a view of how much loyal buyers weigh. Only customers with more than one purchase enter this grouping.
orders-by-resource-error-code-and-message
Checks the errors attached to your orders, if any, grouped by error code and message, so recurring failures surface quickly. Commerce Layer's own description adds an "if any": the answer can come back empty.
orders-by-shipment-status-and-shipping-method-name
Breaks orders down by shipment status and by shipping method name, so you see where parcels stand for each carrier option.
orders-by-status-and-payment-status
Sets order status against the related payment status and totals orders, which brings mismatches between the two into view. The grouping crosses two fields at once, order status and payment status.
orders-paid-with-gift-cards
Tells you how many orders were settled with a gift card, which measures how much that payment method is used. The answer is one total, the orders where a gift card served as payment.
refunds-by-country-and-currency
Totals your refunds grouped by country and by currency, so refund pressure can be compared market by market. The totals cross two dimensions, the country and the currency of each refund.
returns-per-year-by-destination-city
Counts the returns requested on your orders, grouped by year and by destination city, a geographic view of returns over time.
shipments-average-time-in-picking
Measures the average time your shipments remain in picking status before they are packed, a direct gauge of warehouse speed. The measure stops at the moment a shipment is packed.
top-10-spenders-by-currency
Identifies your top-spending customers and shows how each one's total purchases divide across currencies. The list keeps only your top spenders, each total broken down by currency.
What Claude asks before it acts
By default, Claude stops and asks for your go-ahead before any action it takes on an account in your place. With this extension that rarely comes up, since no source describes a write tool.
On a Team or Enterprise workspace, owners decide whether members may let certain actions through without being asked each time, and they can cap what any connector may do for the whole organisation, keeping reading and closing writing for instance. That setting binds everyone. Claude reaches only what the client credentials you entered allow. The official read-only or write-delete label per tool sits in a signed-in account's settings, nowhere public.
Which plans can use it
None of the 819 sheets in the official directory shows availability by plan. That answer, connector by connector, is published nowhere: a real gap in the catalogue.
The general rule is public. Remote connectors are open to all users on Claude, Cowork, Claude Desktop and mobile, while desktop extensions like this one install on Claude Desktop. On Team and Enterprise, an Owner or Primary Owner enables a connector for the organisation before members can connect. For the live status, open the Commerce Layer Metrics sheet in the official directory from your own account.
Where this connector stops
A connector is not an automation. Claude calls these tools while it answers you, and nothing runs on its own when an order comes in or a return is filed.
Only the repository published under the commercelayer organisation on GitHub documents this extension; neither Claude's help centre nor Anthropic's developer docs cover it. By default the sheet exposes reading only, an observed floor rather than a guarantee. The directory's verification badge is not a security audit, and Anthropic says on every sheet that it does not control the tools a publisher exposes. For another sheet read the same way, see the Claude activecampaign connector.
Need help connecting Commerce Layer Metrics to Claude?
A person reads every message.