Connect your own AI agent.
A small program on your computer reads your bank statements there and sends only their rows to your household. Your agent checks the rows against your receipts and entries.
Plus householdsMIT licence, on npm
- Your statementStays on your computer
- The programReads it there
- Your householdGets only the rows
What you need first.
A Plus household
The trial counts.
Agent access on
An admin turns it on in Settings, under Household.
A token
Make one in Settings, under Agents. It starts with eh_pat_ and is shown once.
Node.js 20 or newer
Your agent runs the program with npx.
Add it to your agent.
Settings, under Agents, shows the command with your token already in it. This is what it looks like.
Claude Code
claude mcp add evenhearth -e EVENHEARTH_TOKEN=eh_pat_… -- npx -y @evenhearth/mcp@0.1.0
Other MCP clients (stdio)
{
"mcpServers": {
"evenhearth": {
"command": "npx",
"args": ["-y", "@evenhearth/mcp@0.1.0"],
"env": { "EVENHEARTH_TOKEN": "eh_pat_…" }
}
}
}Swap eh_pat_… for your token. The version is pinned, so it changes only when you change it.
Or add it as a remote connector
https://mcp.evenhearth.com/mcp
In Claude, open Settings, then Connectors, then Add custom connector, and paste this address. Other AI apps take it as a remote MCP server.
No token and no Node.js: you sign in when you connect, and choose what the agent may do.
What your agent can do.
It can’t settle up, close a month, export or change members, plans or billing.
Import
list_accounts- Lists the household’s bank accounts, without account numbers.
bank_export_guide- Shows how to download a statement from a bank’s website.
import_statement_file- Reads a CSV, OFX, QFX or text PDF on your computer and sends its rows. Pictures and scans stay for the app.
import_status- Follows an import until it is done.
Read
whoami- Says which household, plan, mode and permissions the token has.
list_inbox- Lists bank rows not sorted yet, with possible matches.
list_waiting_receipts- Lists receipts waiting to be checked.
search_entries- Finds entries by date, text or category.
list_categories- Lists the categories a row can go under.
month_summary- Totals a month by category and counts what is left to match.
Sort and match
match_candidates- Shows the entries a bank row could belong to.
sort_rows- Files rows as Shared, Mine or Skipped, with a category and a reason.
merge_row- Matches a bank row to an entry or a waiting receipt.
add_entry- Adds an entry. In manual mode it is saved as a draft.
Undo
undo- Takes back a sort, a match or an entry the agent made, while its month is open.
You set how much it does.
Pick Manual or Auto for each token. You can change it later.
Manual
It only suggests. Nothing is sorted or matched until you accept it in the inbox, and its entries are saved as drafts.
Auto
Its moves apply at once. Each one shows under Activity, and you can undo it while the month is open.
Stop it
Revoke a token in Settings, under Agents, and the agent’s next call is refused. Turning Agent access off ends every token in the household.
Where your data goes.
On your computer
The program reads the file here. Only its rows go to your household: the date, the amount and the bank’s description. The agent hands over a path and gets counts back.
At your agent’s company
It sees what the tools return, such as amounts, dates, merchant names and categories, and never account numbers, balances or email addresses. Read its terms before you connect.