ExpenseBot
OnlineReceipt ingestion, Gmail capture, expense analysis, and reviewed reports for AI-agent workflows.
What it can do: 65 tools
get_setup_statusread-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 blindsearch_expensesread-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 merchget_spending_summaryread-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. Iget_deep_analyticsread-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). Retucreate_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_reportsread-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 trequest_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 writeget_report_detailsread-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 thshare_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 rcheck_complianceread-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 billingfix_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_deductibilityread-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 vsearch_knowledgeread-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 troublessubmit_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, tget_last_receipt_resultread-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 batadd_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 Accounparse_expenseread-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 expescan_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 clickiadd_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 Miadd_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. Returadd_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 toget_accounting_integration_statusread-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_statusread-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, polist_categoriesread-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, nolist_tagsread-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 'whatcreate_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 duplicatget_income_summaryread-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 cget_pnlread-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_pnlread-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 thislist_income_categoriesread-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_activityread-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 10trace_documentread-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/finishedget_mileage_summaryread-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_auditread-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, priceIncreasget_expense_by_idread-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 identifiexport_reportread-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 mcp add --transport http expensebot https://mcp.expensebot.ai/mcpSettings → Connectors → Add custom connector
URL: https://mcp.expensebot.ai/mcp{
"mcpServers": {
"expensebot": {
"url": "https://mcp.expensebot.ai/mcp"
}
}
}{
"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
-
TipRanksOnlineOfficial
Live TipRanks market data: analyst ratings, Smart Score, technicals, options, portfolios.
-
GoCardless MCP ServerOnline · sign-in requiredOfficial
Manage GoCardless payments, mandates, subscriptions, refunds and payouts via AI assistants.
-
Avalara AvaTaxOnline · sign-in requiredOfficial
Access Avalara AvaTax API for tax calculation, transactions, nexus management, and compliance
-
Avalara ReturnsOnline · sign-in requiredOfficial
Provides access to Avalara Global Returns API for tax returns, filing calendars, and compliance data
-
Avalara Tax ContentOnline · sign-in requiredOfficial
Provides access to Avalara Tax Content: TTE configs, jobs, communications, lodging, autorental
-
Avalara Tax Registrations and Business LicensesOnline · sign-in requiredOfficial
Provides access to Avalara Tax Registration and Business Licenses APIs for filings and registrations