Automate WooCommerce work with your agents
Maplith maps how WooCommerce’s orders, order lines, products and variations, and customers join your accounting, CRM, payments and helpdesk, so your agent knows where each thing is and how far to trust each join.
| Way | Status | What it means |
|---|---|---|
| Your own agent | Available | Where your agent already has a WooCommerce tool it trusts. Use its read tools only: it can also write. WooCommerce’s MCP integration is a developer preview a developer switches on. |
| Export files | Available | CSV exports: the last three months of orders; all products. The path to start with. |
What your agents do with WooCommerce and Maplith
What starts the work, what your agent does with Maplith, and how it ends. Each flow uses the WooCommerce data and joins described below.
A WooCommerce refund with no credit note
Trigger: Your bookkeeper finds money paid back to a buyer in WooCommerce, and no credit note for it in the accounts.
With Maplith:
- The map:
get_objecton the refunds says each one carries the id of its order, and the order carries the number your accounts book against. The agent lists this month’s refunds in WooCommerce with its own access. - Route:
routefrom each refund to the payment provider’s refund by the transaction id on its order, and to the invoice in your accounting system by order number. Each hop says how far Maplith trusts it. - Findings: Where a scan saw refunds with nothing matching them in the accounts, a finding names them, with its evidence and a recommendation.
- The action gate:
request_actionfor a task for the bookkeeper: each refund, its order number, and the credit note it still needs. The key’s policy decides whether it goes straight through. - Record and value:
record_actionrecords that the list reached the bookkeeper, and later which refunds were booked.
Result: The bookkeeper books each missing credit note against the right order number, from one list.
One buyer, a guest checkout and an account
Trigger: Your marketing list counts one person twice: once as a registered customer, once from orders placed as a guest.
With Maplith:
- Ask:
ask: “how do WooCommerce’s guest orders tie to a registered customer?” The answer cites its joins: a guest order links only by its billing email. - Route:
routefrom the WooCommerce customer to the contact in your CRM by customer email, with how much Maplith trusts that hop. - The map:
get_objecton the customers says which fields hold the order count and the total spend, so the agent compares the two records in WooCommerce with its own read access. - The action gate:
request_actionfor a task for whoever owns the customer list, with both records and the email that joins them. Merging them stays that person’s call. - Record and value:
record_actionrecords the task and what the person decided.
Result: A person decides whether the two records are one buyer, with the match and its evidence in front of them.
Paid at the payment provider, pending in WooCommerce
Trigger: A buyer says the order is paid, and WooCommerce still shows it as pending payment.
With Maplith:
- Task context: Your agent hands the buyer’s message to
get_task_context, and gets back the playbook you wrote for payment questions, if there is one, and what its key may do. - Route:
routefrom the WooCommerce order to the payment at Stripe or PayPal by the order’s transaction id. - The map:
get_objecton the order says which field carries its status; the agent reads the order in WooCommerce and the payment in Stripe, each with its own read access. - The action gate:
request_actionfor a task for whoever handles payments: the order, the payment found at Stripe or PayPal, and the status the order should have. A person marks it paid in WooCommerce; Maplith never changes the order. - Record and value:
record_actionrecords the task and how it ended.
Result: The person who handles payments gets the order and the payment that settles it, side by side.
How it connects
Through access you already have. Maplith holds no WooCommerce credential and never writes there.
- Connect your assistant to Maplith over MCP, by signing in or with an agent key.
- Your agent reads WooCommerce with a WooCommerce tool it already trusts. Use its read tools only: it can also write.
- With your approval it sends what it read; Maplith builds the map and deletes the files again.
What Maplith never reads or does
- WooCommerce itself: Maplith holds no WooCommerce credential and never signs in to it.
- Anything that changes WooCommerce: 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 with its status, totals, payment method and billing details.
- order id
- order number
- customer id
- billing email (Maplith tries to mask it)
- payment method
- transaction id
- status
- created date
Order lines
One product line on an order with quantity and line total.
- order id
- product id
- variation id
- SKU
- quantity
Products and variations
One product or variation with its SKU, price, stock and categories.
- product id
- SKU
- parent (ID or SKU)
- type
- stock
Customers
One registered customer or guest buyer with order count and total spend.
- customer id
- customer email (Maplith tries to mask it)
- order count
- total spend
- registration date
Refunds
One refund on an order with amount and reason.
- refund id
- order id
- amount
- created date
The narrowest access WooCommerce offers for reading
- Permissions: Read
Questions about WooCommerce and Maplith
Does Maplith copy my WooCommerce data?
Which WooCommerce access does Maplith need?
Permissions: Read, never Read/Write.