EvenHearthInvite only · TestingClosed · Testing

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

  1. Your statementStays on your computer
  2. The programReads it there
  3. 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.

Get it from npm.

Questions? Write to support@maliko.ca