Automate Shopify work with your agents
Maplith maps how Shopify’s orders, transactions, products and variants, and customers join your accounting, helpdesk, payments, recurring orders and CRM, so your agent knows where each thing is and how far to trust each join.
| Way | Status | What it means |
|---|---|---|
| Your own agent | Available | Shopify connector for Claude or Shopify plugin for ChatGPT, approved for read access only. |
| Export files | Available | CSV exports: orders for the last three months; all products and all customers. |
What your agents do with Shopify and Maplith
What starts the work, what your agent does with Maplith, and how it ends. Each flow uses the Shopify data and joins described below.
A customer asks where their order is
Trigger: A customer writes to your helpdesk: the order has not arrived.
With Maplith:
- Task context: Your agent passes the case to
get_task_contextand gets the playbook for late orders, if you put one in use, and what its key may do. - Route:
routefrom the helpdesk conversation to the Shopify order, by the customer’s email or the order number, with how much Maplith trusts each hop. - The map:
get_objecton the order says where its fulfillment status and shipping label live, by order number; the agent reads both with its own access. - The action gate: It drafts the answer, and
request_actiondecides whether a person approves it before it is sent: by your agent in Intercom, only with write access you give it there separately, or by that person in Zendesk. - Record and value:
record_actionrecords that the answer went out, and how the case ended.
Result: The customer gets an answer drawn from the order itself, approved the way you decided.
A payout that does not match the books
Trigger: At month-end, the payments behind a payout and the bank line in your accounts disagree.
With Maplith:
- Ask:
ask: “how do Shopify’s transactions tie to a payout and to the bank?” The answer cites the joins it rests on, and what the map could not establish. - Route:
routefrom the transactions to the payout by order and amount, then to bank lines and accounting by payout. The payout itself comes from Shopify Payments or your payment provider, so your agent reads it there with its own access. - Findings: Any finding where a scan already saw the two sides disagree, with its evidence and a recommendation.
- The action gate:
request_actionfor a task for the bookkeeper with the payout, the payments behind it and the bank line they should match, decided by the key’s policy. - Record and value:
record_actionrecords that the task went to the bookkeeper, and how the check ended.
Result: Your agent knows which keys tie each order to the money in the bank, and which hops to check by hand.
A refund in Shopify that never reached the books
Trigger: At month-end, your bookkeeper asks whether every refund in Shopify was booked against its invoice.
With Maplith:
- The map:
get_objecton the transactions says a refund is a transaction of the kind refund, keyed by order number; the agent reads the month’s refunds in Shopify with its own access. - Route:
routefrom the refund to its order, then to the invoice in your accounting system by the order reference, with how much Maplith trusts each hop. - The action gate:
request_actionfor a task for the bookkeeper with the refund, its order and the reference to book it against, decided by the key’s policy. The month’s refunds go in one task. - Record and value:
record_actionrecords that the task went to the bookkeeper, and how the check ended.
Result: The month’s refunds reach the bookkeeper as one task, each with its order and the reference to book it against.
How it connects
Read-only, through access you already have. Maplith holds no Shopify credential.
- Connect your assistant to Maplith over MCP, by signing in or with an agent key.
- Your agent reads Shopify with the Shopify connector for Claude or the Shopify plugin for ChatGPT, approved for read access only.
- With your approval it sends what it read; Maplith builds the map and deletes the files again.
What Maplith never reads or does
- Shopify itself: Maplith holds no Shopify credential and never signs in to it.
- Anything that changes Shopify: Maplith never writes there. When your agent acts, it uses access you gave it.
- What you leave out: you decide what your agent shares or an export contains.
Datasets that make a good map
Orders
One order line: the order, its status and totals, and one product line with quantity and price.
- order id
- order name (order number)
- line item SKU
- customer email (Maplith tries to mask it)
- created date
- financial status
- fulfillment status
Transactions
One captured payment or refund on an order.
- order name (order number)
- kind
- gateway
- status
- amount
- currency
- created date
Products and variants
One product variant with its handle, SKU, price and inventory settings.
- product handle
- product id
- variant id
- variant SKU
- vendor
- product type
Customers
One customer account with order count, total spent, tags and marketing consent.
- customer id
- customer email (Maplith tries to mask it)
- tags
- total orders
- total spent
Inventory
Stock for one variant at one location.
- variant SKU
- location
- available quantity
The narrowest access Shopify offers for reading
- read_orders
- read_all_orders
- read_products
- read_customers
- read_inventory
- read_locations
- read_shopify_payments_payouts
Questions about Shopify and Maplith
Does Maplith copy my Shopify data?
Which Shopify access does Maplith need?
read_orders, read_all_orders, read_products, read_customers, read_inventory, read_locations and read_shopify_payments_payouts.