# Heo Agent > Heo Agent is a cute, AI-first expense and income tracker. Type “12.50 lunch @visa” or tell Claude or ChatGPT what you spent. Any currency with live exchange rates, budgets, wallets and recurring bills. Heo Agent is an AI-first personal finance tracker (expenses, income, wallets, transfers, budgets, recurring items) with a cute piggy-bank mascot, Heo. People use it from the web app at https://heoagent.app or from AI assistants (Claude, ChatGPT) through its remote MCP server. The interface is in English and Vietnamese; it works with any currency. It is in early access and free to use. ## Key facts - Web app: https://heoagent.app/sign-in (sign in with Google). iOS and Android apps are in development. - MCP server (Streamable HTTP, OAuth 2.1 with PKCE and dynamic client registration): https://heoagent.app/mcp - OAuth metadata: https://heoagent.app/.well-known/oauth-authorization-server and https://heoagent.app/.well-known/oauth-protected-resource/mcp - Data: stored in Heo Agent's database on Cloudflare; exportable as CSV, JSON or a markdown ledger; account deletion erases it. No bank connections, no ads. - Currencies: any major currency. Conversions to/from VND use live Vietcombank rates (bank sell rate for expenses, transfer rate for income); other pairs use daily market rates; past dates use that date's rate. The original foreign amount is kept. ## Connect from an AI assistant 1. Claude: Settings → Connectors → Add custom connector. ChatGPT: Settings → Connectors → Create. 2. Paste https://heoagent.app/mcp, sign in with Google, approve access. 3. Ask things like "log 35k grab and 100 THB massage" or "how much did I spend on food last month?". MCP tools: get_account_info, update_settings, list_accounts, upsert_account, reconcile_account, add_transactions (structured items or free text in the quick-add syntax), list_transactions, update_transaction, delete_transaction, get_summary, list_categories, upsert_category, list_recurring, create_recurring, update_recurring, delete_recurring, convert_currency, search, fetch. ## Quick-add syntax One transaction per line; only the amount is required. - `12.50 lunch`: Expense of 12.50 in your currency, category guessed (Food) - `+3200 salary #salary @bank`: Income into your Bank wallet, category Salary - `€20 museum`: Foreign currency, converted at that day’s rate (original kept) - `200 @bank > @savings`: Transfer between wallets - `yesterday 8.40 coffee`: Date words: today, yesterday, weekdays, 15/11, 2026-11-15 - `45k phở · 1tr2 rent`: Vietnamese shorthands work too (k = thousand, tr = million) - Amounts: `12.50`, `1,250.75`, currency symbols or codes (`$45`, `€20`, `100 THB`). Vietnamese shorthands: `k` = thousand, `tr` = million (`1tr2` = 1,200,000). Leading `+` = income. - `#category` (first tag is the category, more tags allowed), `@wallet`, `@from > @to` transfer, `= AMOUNT` for what arrived on the other side of a transfer. - `- 77632 [100 THB] pad thai` (ledger line) records the VND amount and the original foreign amount. - Date words: today, yesterday, weekday names, explicit dates (15/11, 2026-11-15); Vietnamese hôm nay, hôm qua. ## Pages - [Home (English)](https://heoagent.app/) - [Trang chủ (Tiếng Việt)](https://heoagent.app/vi) - [Privacy policy](https://heoagent.app/privacy) - [Terms of use](https://heoagent.app/terms)