Agents Index

ExpenseBot

Online

Receipt ingestion, Gmail capture, expense analysis, and reviewed reports for AI-agent workflows.

Visit publisherConnectJSON

What it can do: 65 tools

  • get_setup_status read-onlyRead authoritative setup, known answers, next question and eligible actions for the current workspace. Ask only missing prerequisites; optional setup must not block a specific expense task. Unknown is not empty/complete.
  • complete_setupPreview explicit setup answers, never infer. Show changes/access/recipients; approval then proposalId+confirm:true only. Owner/revision-bound; rejects changed state. Lost reply: proposalId+status:true; never resend blind
  • search_expenses read-onlySearch spreadsheet expenses by category, merchant, dates, amount or tags. When hasMore, reuse nextCursor with identical filters; avoid overlapping ranges. Optional query does deterministic non-embedding recall over merch
  • get_spending_summary read-onlySummarize the user's recorded expenses with totals and breakdowns by category, merchant, month, tag, source, or payment method. Supports date ranges, period comparisons, and total, count, or average metrics. Read-only. I
  • get_deep_analytics read-onlyRun deeper, multi-step analytics on the user's expenses. Use for explanatory questions like 'why did my spending increase' or 'compare Q1 vs Q2'. Takes 10-30 seconds (runs as a background job, polled automatically). Retu
  • create_reportCreate a report for clear date/client/project/trip/category/merchant criteria. Tags group clients/projects/codes/trips; list_tags if unclear. excludePersonal=true excludes both Personal tag and Personal expense category,
  • list_reports read-onlyList the user's expense reports with pagination. Filter by status (All, Draft, Submitted, Shared). Each exact report includes its app, Bill Client, and accounting handoff URLs. Use the matching accounting URL only when t
  • request_accounting_integrationRequest an exact accounting package only after checking reviewed direct/import-file destinations and finding no match. Do not use this for a listed or Beta destination or general compatibility. A confirmation-gated write
  • get_report_details read-onlyGet full details of a specific expense report including all expenses, totals, and compliance status. Use only when the user explicitly asks to inspect an existing report's details. Without checkFreshness:true, returns th
  • share_reportShare one existing expense report with user-named recipients. No server preview: shares and emails on call. Default to reviewer: they can open and edit that report's Google Sheet, inspect receipts, comment, approve, or r
  • check_compliance read-onlyUse only when the user explicitly asks to check an existing report for compliance issues such as missing business purpose or policy violations. Creating a report, excluding Personal expenses, sharing a report, or billing
  • fix_complianceFix recorded expenses only after an explicit request to fix check_compliance findings; follow correct_expenses. Use exact expenseIds from search_expenses; never select all report rows or infer purpose/category/attendees.
  • check_tax_deductibility read-onlyUse this when the user asks for general deduction guidance for an expense type, such as business meals or home-office expenses. Looks up reference rules using the account's tax-country/home settings and current year. A v
  • search_knowledge read-onlySearch ExpenseBot's complete product and help knowledge base. Use this before guessing when the user asks how a feature works, what ExpenseBot supports, or needs setup, billing, Gmail, scan, report, workflow, or troubles
  • submit_receiptProcess receipt images/PDFs, including 'log this', 'save this receipt', 'expense this', 'add this to my expenses' or a shared receipt/invoice photo. Starts on call (no server preview); AI extracts vendor, amount, date, t
  • get_last_receipt_result read-onlyRead the authoritative outcome of a receipt batch: a submit_receipt batch by its exact ID (submissionId), or the latest upload (including in-app) via withinSeconds. Poll at the returned interval/time allowance (small bat
  • add_cash_expenseAdd one receiptless expense or client-provided expense advance to the expense sheet after the user confirms; no server preview, it writes on call. Ordinary expenses: list_categories first; use a configured Expense Accoun
  • parse_expense read-onlyParse a natural language expense description into structured fields. Does NOT add the expense: returns fields to show the user; once they approve, save with add_cash_expense. Example: "Lunch at Chipotle $15.50 today" → {
  • process_gmail_receiptsProcess specific Gmail emails as receipts when the user supplies Gmail message IDs; to find receipts use scan_gmail. No server preview: on call each email is converted to PDF, extracted by AI and added to the user's expe
  • scan_gmailTrigger a background Gmail scan to discover and process receipt emails from the last ~60 days (default). No server preview: starts on call and runs in the background; the user gets an email summary when done. Like clicki
  • add_mileage_entryLog one user-confirmed business trip; writes on call, no server preview. Saved mode selects rate-based expense or distance-only trip; trackingMode overrides. For routes, vehicle setup/readings, imports or review, open Mi
  • add_incomeLog exactly one confirmed income payment (cash/check/Stripe/etc.) to Income, e.g. income absent from Gmail/Plaid; no server preview, it writes on call. Never loop over statements/exports/tables/lists. Multiple payments:
  • add_income_from_fileImport income from attached JPEG/PNG/WebP/HEIC/HEIF screenshots/images or PDF (payment/wallet/payout/bank statement; max 10 MB). Step 1: file WITHOUT confirm uses Add Income's parser and Income-tab duplicate check. Retur
  • add_income_from_csvUse this to import the user's CSV/TSV/text income export (max 500 KB). Step 1 stages a duplicate-checked previewId without writing Income rows. Show it and obtain approval. Step 2 uses confirm:true and that previewId to
  • get_accounting_integration_status read-onlyRead the owner's accounting connection/setup state, selected organization/company/business, rollout state and one connect/reconnect setupUrl. Pass an existing reportId to open that exact report's provider setup control;
  • send_report_to_accountingPreview then post an owner's report to accounting. Step 1: provider/reportId, optional mode/mappings, NO confirm. Reads live report/destination, enforces Omit/Personal/split/date/currency rules and Zoho bank-feed checks;
  • get_accounting_push_status read-onlyRead the authoritative posting and reconciliation status for one ExpenseBot report at an accounting destination. Use after a timeout or uncertain response before considering any retry. Returns status, submission time, po
  • list_categories read-onlyList the user's configured expense categories and billing accounts. Use this BEFORE calling tools that need a category (add_cash_expense, add_mileage_entry, create_report) so you pass the user's actual category names, no
  • list_tags read-onlyList the user's configured groups. ExpenseBot stores clients, projects, project codes, properties, and trips as tags (for example 'Client: Acme', 'Vegas Trip', or 'Property: 123 Main'). Use this when the user asks 'what
  • create_tagCreate a standalone group/tag without selecting or changing any expenses. The first call prepares a preview; after the user explicitly chooses to create it, send confirm:true with the returned operationId (fresh duplicat
  • get_income_summary read-onlyUse this when the user asks about income already recorded in their ExpenseBot Income tab. Read totals; group by source, category, month, payment method or tag; filter by dateRange/incomeTagPrefix. Query supports period c
  • get_pnl read-onlyCompute Profit & Loss (P&L / net income / margin) by combining the Income tab with expense tabs. Examples: 'am I profitable this year', 'P&L for Q1', 'net income last quarter', 'what's my margin', 'P&L this year vs last'
  • get_per_tag_pnl read-onlyPer-tag P&L — revenue, cost, profit, and margin grouped by tag (per-client, per-property, per-event, per-realtor-deal). Requires both income AND expense rows to be tagged with matching labels. Examples: 'per-tag P&L this
  • list_income_categories read-onlyList ExpenseBot's fixed income tax categories. Unlike Expense Accounts, these are not user-configured. Use this BEFORE calling add_income so you pass an exact canonical category instead of guessing.
  • get_recent_activity read-onlyRead recent MCP assistant tool calls: tool, time, arguments and success, not document processing history. Use for 'what did I do this week' or 'which tools has my assistant run'. Returns audit entries, default 20, max 10
  • trace_document read-onlyRead a receipt/invoice/forwarded email/Gmail receipt/PDF's lineage timeline: missing, skipped, income-routed, deduped or duplicate-removed documents. Not Gmail scan-job status/progress/completion (running/queued/finished
  • get_mileage_summary read-onlyRecorded mileage expenses and Trip Log distances, with month/client/purpose/category breakdowns and date ranges. Expense amounts are not tax-deductibility determinations.
  • get_subscription_audit read-onlyFind recurring subscriptions, duplicate charges, price increases and trial-conversion suspects in recorded expenses, optionally by cost (e.g. over $20/month). Returns message/data with recurring, duplicates, priceIncreas
  • get_expense_by_id read-onlyRead one existing expense from the authenticated user's ExpenseBot spreadsheet. Supply the exact expenseId returned by search_expenses (Receipt ID in Column Q), or the user's specified rowNumber. Never invent an identifi
  • export_report read-onlyGet a short-lived direct PDF download for one exact authorized expense report, plus the exact highlighted in-app report link. Use the in-app report for CSV, XLSX, receipt ZIP (when available), comments, invoicing, and ot

…and 25 more.

Connect it

Claude Code
claude mcp add --transport http expensebot https://mcp.expensebot.ai/mcp
Claude.ai / ChatGPT
Settings → Connectors → Add custom connector
URL: https://mcp.expensebot.ai/mcp
Cursor (~/.cursor/mcp.json)
{
  "mcpServers": {
    "expensebot": {
      "url": "https://mcp.expensebot.ai/mcp"
    }
  }
}
VS Code (.vscode/mcp.json)
{
  "servers": {
    "expensebot": {
      "type": "http",
      "url": "https://mcp.expensebot.ai/mcp"
    }
  }
}

Questions

What does ExpenseBot do?

Receipt ingestion, Gmail capture, expense analysis, and reviewed reports for AI-agent workflows. It exposes 65 tools to AI assistants.

What tools does ExpenseBot provide?

65 tools, including get_setup_status, complete_setup, search_expenses, get_spending_summary, get_deep_analytics, create_report, list_reports, request_accounting_integration, get_report_details, share_report, check_compliance, fix_compliance….

How do I connect ExpenseBot to Claude, ChatGPT or Cursor?

Add the remote MCP endpoint https://mcp.expensebot.ai/mcp as a custom connector or MCP server. Copy-paste setup is on this page.

Does ExpenseBot require an account or API key?

No sign-in was needed to list its tools. Individual tools may still need an account or API key.

Is ExpenseBot online?

As of 2026-11-19 our probe found it online. It answered 100% of our last 3 checks.

Who publishes ExpenseBot?

@TotesMagotes on GitHub. The official MCP Registry verified that the publisher controls this GitHub account before accepting the listing.

Similar in Finance & Payments