1. Docs
2. /
3. Tool reference
4. /
5. Commerce
6. /
7. exportOrders

Commerce

exportOrders

Export Orders

Export a shop's orders as a CSV file (the same file the Orders tab's Export button makes) under the same plain-words filter as listOrders: a period on the placed or the due date, status, stage, a…

read

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "export last month's orders", and it calls exportOrders.

Example call

The MCP tools/call params, with the required arguments only.

{
  "arguments": {},
  "name": "exportOrders"
}

Arguments

• channelstringoptionalWhich counter rang the sale: POS (the register), Online (storefront, CakeBuilder and other apps, payment links) or Manual (logged by hand).
• customerEmailstringoptionalOnly this customer's orders, by the email on the order.
• dateFieldstringoptionalWhich date the period applies to: "placed" (when the order was taken, the default) or "due" (the pickup, delivery or event day).
• fromstringoptionalFirst day of a custom period, YYYY-MM-DD, included. Only with period "custom".
• locationIdstringoptionalOnly orders at one of the shop's locations (see listLocations).
• menustringoptionalA menu (product set) by name or id, e.g. "Thanksgiving 2026": only orders that sold something on it (see listProductSets). A near name is matched; a miss lists the menus that exist.
• periodstringoptionalThe period in plain words: today, yesterday, last_7_days, last_30_days, this_month, last_month, this_year, all (the default), or custom with from and to. Days are the shop's own.
• productIdstringoptionalOnly orders that sold one product (see listProducts).
• spacestringoptionalSpace id or slug of a Space-owned shop (see listPageSpaces). Omit for your personal shop.
• spaceIdstringoptionalSame as `space`: the Space id (see listPageSpaces) of a Space-owned shop. Pass either one. Omit both for your personal shop.
• stagestring[]optionalOnly these stages of the work: unfulfilled, in_progress, ready, fulfilled, cancelled. Omit for every stage.
• statusstring[]optionalOnly these order statuses: pending (new), confirmed, completed, cancelled. Omit for every status.
• textstringoptionalFree text: an order number, a customer's name, email or phone, whatever is in hand.
• tostringoptionalLast day of a custom period, YYYY-MM-DD, included. Only with period "custom".
• columnsstring[]optionalColumn names to keep, in the file's own words (e.g. "Date", "Order ID", "Customer", "Total"). Omit for every column.
• grainstringoptionalOne row per order ("transaction", the default) or one row per line sold ("line_item").

Returns

Returns the CSV text, its file name (the title in words), the row count, whether the file stopped short of the filter, where to start the next page when it did, and an access receipt (who exported,…

Ask for it

The Cloud routes these requests to this verb.

• export last month's orders
• orders report as a spreadsheet
• give me a CSV of this week's pickups
• export the Thanksgiving orders
• download orders for my accountant

Pair it with

The verbs that finish the job.

• listOrders

Questions

• What does exportOrders do?

  Export a shop's orders as a CSV file (the same file the Orders tab's Export button makes) under the same plain-words filter as listOrders: a period on the placed or the due date, status, stage, a… It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use exportOrders from Claude or ChatGPT?

  Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "export last month's orders", and it calls exportOrders.

• Is exportOrders safe to let an AI call?

  exportOrders is read-only: it changes nothing.

Connect

One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.