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

Commerce

recordExpense

Record Expense

Record ONE expense in the shop's books: the day it was paid, the vendor, a category, the amount, and optionally the receipt file.

write

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "log this receipt", and it calls recordExpense.

Example call

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

{
  "arguments": {
    "amountCents": 1,
    "category": "<category>",
    "date": "<date>",
    "vendor": "<vendor>"
  },
  "name": "recordExpense"
}

Arguments

• amountCentsintegerrequiredNo description is declared in the tool schema.
• categorystringrequiredNo description is declared in the tool schema.
• currencystringoptionalNo description is declared in the tool schema.
• datestringrequiredThe day it was paid, YYYY-MM-DD.
• idempotencyKeystringoptionalNo description is declared in the tool schema.
• notestringoptionalNo description is declared in the tool schema.
• receiptFileIdstringoptionalStorage file id of the receipt, from an upload.
• spacestringoptionalThe Space (shop) the invoice belongs to: its id, slug or exact name. Omit for the caller's personal shop.
• spaceIdstringoptionalA Space id or its team id; same as space.
• vendorstringrequiredNo description is declared in the tool schema.

Returns

The registry does not declare a return shape.

Declared limits

• amountCents: greater than 0
• amountCents: maximum 9999999999
• category: minimum length 1
• category: maximum length 120
• currency: minimum length 3
• currency: maximum length 3
• idempotencyKey: minimum length 8
• idempotencyKey: maximum length 100
• note: minimum length 1
• note: maximum length 1000
• vendor: minimum length 1
• vendor: maximum length 120

Ask for it

The Cloud routes these requests to this verb.

• log this receipt
• I spent $420 at Home Depot on materials
• add an expense

Pair it with

The verbs that finish the job.

• listExpenses
• readProfitAndLoss

Questions

• What does recordExpense do?

  Record ONE expense in the shop's books: the day it was paid, the vendor, a category, the amount, and optionally the receipt file. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use recordExpense 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 "log this receipt", and it calls recordExpense.

• Is recordExpense safe to let an AI call?

  recordExpense changes your workspace. What an AI creates is Private until you share it.

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.