get_spending_analytics

Answers questions about how much the user spent or earned — totals plus category, tag, and vendor breakdowns.

Use with an AI agent

Export this page as Markdown or bundle it with a task for your agent.

Try a task
Preview the prompt that will be copied

Access

  • Effect: Read-only
  • Required scope: read (the mcp scope also grants it)

Example request

The JSON-RPC message an MCP client sends to call this tool. Your client builds it for you; this is for reference and debugging in a tool such as MCP Inspector.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_spending_analytics",
    "arguments": {}
  }
}

Example IDs refer to fictional demo data. Replace them with IDs from your account before calling the real server.

Description

Answers questions about how much the user spent or earned — totals plus category, tag, and vendor breakdowns.

Returns a `report` field with emoji labels (e.g. "🍽️ Food & Drink: $459.00 USD") — present `report` verbatim to the user; do not strip emojis or reformat amounts.

Also returns `charts` (labels + values) for category spend — when present, ALWAYS render a chat-visible bar chart/image; do not reply with numbers only or write source files.

Use this for: "How much did I spend on food this month?", "What's my total income this year?", "Which vendors cost me the most?", "chart my spending".

Income vs expense follows transaction type (same as list_transactions), not amount sign.

from/to are RFC 3339 date strings. Either bound is optional. accountIds is optional — omit to include all accounts; call list_accounts to get IDs for filtering. Transfers are excluded by default; set includeTransfers=true to include them.

Input parameters

NameTypeRequiredDescription
accountIdsarrayNo
fromstringNo
includeTransfersbooleanNo
tostringNo
Full input schema (JSON Schema)
json
{
  "additionalProperties": false,
  "properties": {
    "accountIds": {
      "items": {
        "type": "string"
      },
      "type": [
        "null",
        "array"
      ]
    },
    "from": {
      "type": [
        "null",
        "string"
      ]
    },
    "includeTransfers": {
      "type": [
        "null",
        "boolean"
      ]
    },
    "to": {
      "type": [
        "null",
        "string"
      ]
    }
  },
  "type": "object"
}