Resources · Claude connector

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

Overview

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.

Vocabulary

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.
Connect

Plug Commerce Layer Metrics into Claude in three steps

  1. 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.

  2. 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.

  3. 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.

Tools

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

What Claude reads (33)

33 tools

Thirty-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.

When it helps
a head of e-commerce wants revenue split by market for the board deck.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
a trading manager checks whether last week's campaign lifted daily order value.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
a founder wants the average order value this quarter in one sentence, not a table.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
a growth marketer compares cart values across markets to decide where to test a free shipping threshold.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
a product owner wants to see whether a checkout redesign coincided with more carts per day.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
a merchandiser needs the typical number of items per basket to size a bundle offer.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
an operations lead wants returned amounts grouped by market before a supplier review.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
a logistics planner checks whether returns spike in January after the holiday rush.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
a finance controller needs the total value returned last month for the closing.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
a category manager wants cross-sell suggestions for a new flagship product.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
an international team compares what leads sales in France against Spain before a joint campaign.

Sourcegithub.com · October 1, 2026 ↗

customers_that_bought_a_specific_product

Counts the customers who purchased a specific product or bundle, a fast measure of reach for one item.

When it helps
a product manager wants to know how many people own an item before announcing an accessory for it.
Watch out
the repository spells this name with hyphens; the sheet's underscores are what Claude uses.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
a merchandiser builds product bundles for a seasonal landing page.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
after a stock issue, a country manager wants to see who just added the affected item.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
a back-office lead verifies that a cleanup of old orders went as planned.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
a B2B sales rep wants the recent orders placed by staff of one client company.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
a logistics team sizes packaging differently for markets where baskets run larger.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
a marketer reports on a spring sale code the week after it ends.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
a product team decides which bundles to keep for the next season.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
a finance lead prepares currency exposure figures for the treasury meeting.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
a store manager wants to see which weekdays bring the most orders before planning staff.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
a retention manager makes the case for a loyalty programme with real repeat figures.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
a developer investigates why a payment step keeps failing for some customers.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
a fulfilment lead spots that express orders pile up in one status more than standard ones.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
a finance team looks for orders marked approved whose payment is still pending.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
a marketer evaluates last December's gift card push by its redemptions in January.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
a controller explains to management why refunds weigh more in one region.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
a logistics manager weighs opening a local return point in the city with the most returns.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
an operations director checks whether a new warehouse layout shortened preparation.

Sourcegithub.com · October 1, 2026 ↗

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.

When it helps
a key account team prepares a VIP list for an invitation-only event.

Sourcegithub.com · October 1, 2026 ↗

Approvals

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.

Plans

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.

Limits

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

Need help connecting Commerce Layer Metrics to Claude?

A person reads every message.

FAQ

Claude Commerce Layer Metrics connector: common questions

01What can Claude do with the Commerce Layer Metrics connector?
Claude can analyse your Commerce Layer order, cart and return history through the Metrics API. Twelve tools run breakdowns, date breakdowns, statistics and searches on those three resources, one runs a frequently bought together analysis, and twenty package common reports such as best sellers per market, orders paid with gift cards or average time in picking. You ask a business question in plain words, and Claude picks the tool, runs it and explains the figures.
02Can Claude place, edit or cancel orders through this connector?
No tool on the sheet is described as writing. All thirty-three query, aggregate or search existing data, so Claude has nothing to place, edit or cancel through them. A read-only list is still an observed floor rather than a guarantee, since an administrator can open actions that no public sheet shows. Changes to orders, prices or promotions stay in Commerce Layer itself or in your usual back office. Claude helps you decide; you act.
03Does Claude ask before it acts?
By default, yes: Claude asks for confirmation before any action it carries out on an account on your behalf. With this extension the question is mostly theoretical, because every tool only reads. No source describes a confirmation specific to these tools, so the general rule applies. On Team and Enterprise workspaces, owners decide whether members may let some actions through without being asked, and they can close writing for the whole organisation.
04Which plans is it available on?
No official source publishes plan availability connector by connector, and no directory sheet shows it. The general rule says remote connectors are open to all users on Claude, Cowork, Claude Desktop and mobile, while desktop extensions such as this one install on Claude Desktop. On Team and Enterprise, an Owner or Primary Owner enables each connector for the organisation first. The directory sheet remains the only place that shows the current status for your account.
05Does Claude see all of our Commerce Layer data?
Claude sees what the client ID and client secret you entered allow, nothing beyond. The tools then cover orders, carts and returns through the Metrics API, so other areas of Commerce Layer stay out of reach except where they appear inside those records. Some reports name customers, such as top spenders, so treat answers as business data. On a Team or Enterprise workspace, an owner can also restrict the connector for everyone.
06Why does Claude not find this connector in the browser?
Because it is a local extension that runs on Claude Desktop. The directory lists it as a desktop extension, and its repository describes building it as a local server or installing a packed bundle in Claude Desktop, with your client ID and secret entered at install. It does not follow you to Claude in a browser or on mobile. If you need the data elsewhere, open Claude Desktop on the machine where the extension is set up.
07Claude or an automation tool for Commerce Layer reporting?
They do different jobs, so choose by task. Claude, through this extension, answers analytical questions on demand: you ask, it queries the Metrics API and explains, then it stops. It does not send a weekly sales report by itself or alert you when returns spike. Recurring reports and threshold alerts are work for an automation tool. For exploring your data and getting a quick, explained answer, the connector fits. The choice depends on whether a person is asking.