Life Budget · Connector documentation

The Life Budget connector

Reference for Life Budget’s MCP server: how to connect an AI app, how the connection is secured, what your AI can and can’t see, and every tool it offers. For the overview, see Connect your AI.

Updated 12 November 2026

At a glance

Server address

https://api.life-budget.com/mcp/

Transport

Streamable HTTP

Sign-in

OAuth 2.1 with PKCE, through your Life Budget account. Apps can register themselves, by dynamic client registration or a client ID metadata document. Claude Code and Gemini CLI can use a personal API key instead.

Tools

94: 33 only read, and 61 add or change something.

Plans

The connector is on every plan. A tool that needs a paid plan says which one and links to the upgrade.

Connect an AI app

  1. Create a free Life Budget account and add your numbers

    The connection carries your data, so there has to be data. Add accounts, debts and expenses by hand, or let the onboarding wizard walk you through it. A budget and at least one saved simulation give an assistant the most to work with.

  2. Open Settings → Connections

    Every way of connecting an outside assistant lives on one page, at /profile?tab=connections. Nothing is enabled by default; an unconnected account has no external surface at all.

  3. Connect through your assistant, or mint a key

    Clients that speak OAuth — Claude, ChatGPT and Grok among them — take the endpoint https://api.life-budget.com/mcp/ and send you through Life Budget’s sign-in and multi-factor authentication on /connect. Clients that take a header instead (Claude Code, Gemini CLI) use a personal API key, which you create in Settings → Connections behind multi-factor authentication.

  4. Approve the connection, then ask it something

    An AI app you haven’t approved waits for your approval (within 15 minutes of its first call, on /connect or in Settings → Connections), where you acknowledge that anyone who can use your AI account can use Life Budget through it, and agree to keep that account protected with two-step verification or similar sign-in protection; we also email your account’s address whenever a connection is approved. Once approved, ask a question you could not have answered from memory — "what did I actually spend on groceries last quarter, and what would cutting it by 15% do to my FI date?"

Security and permissions

You sign in every time an app connects, and approve each app you connect.

Every time an AI app connects, including one you connected before, you sign in to Life Budget with your second factor first. An app you haven’t approved then waits on /connect (and in Settings → Connections) for 15 minutes until you approve it; when you do, you acknowledge that anyone who can use your AI account can use Life Budget through it, and agree to keep that account protected with two-step verification or similar sign-in protection. A connection lasts at most 40 days, or 14 days without use, and then the app must be connected and approved again. Disconnecting ends its authorization. A name the app gave itself is marked unverified, because nothing confirms it.

Every sign-in and approval needs multi-factor authentication, and we email you.

Signing in to connect an AI app, approving a connection, and creating a personal API key all require your second factor, and are held for 72 hours after an MFA reset. Every time a connection is approved, we email your account’s address with the app’s name, when it was approved, and how to disconnect it.

The connection is you, and only you.

Your identity comes from the sign-in, never from a request. No tool takes a user id, so there is no call an app could make that reaches anyone else’s data.

Nothing is deleted without you.

An AI can ask to delete one thing, and asking only gives it a link. Nothing goes until you open it in Life Budget, see exactly what would be deleted and approve it. A request you ignore lapses after 24 hours. Transactions can’t be deleted over the connection at all.

Some things stay in the app.

Linking or unlinking a bank, billing, sign-in and MFA settings, and deleting your account are only in Life Budget, by you. Life Budget can’t move money at all.

Encrypted underneath.

Sensitive fields are encrypted with AES-256-GCM under a key unique to your account before they reach the database.

One thing we don’t control.

Once an answer reaches your AI app, that provider’s settings decide what happens to it. Before you connect, consider turning off training on your conversations and memory there.

What your AI sees

Every result is built from a list of allowed fields, so a field added to Life Budget later stays out until someone deliberately adds it. Account and card numbers arrive as their last four digits.

Sent
  • Amounts, dates, merchants
  • Categories, tags, notes and your rules
  • Your plan’s inputs and projected years
  • Balances and returns, by account type
Never sent
  • Bank credentials and Plaid access tokens
  • Your user id — and anything holding one
  • MFA status, recovery codes, encryption keys
  • Where you physically were when you paid
  • Billing and payment identifiers
  • Other members of a shared profile

Tools

Each tool’s title and label below is exactly what AI apps receive from the server. The label says what the tool does to your records:

Reads

Changes nothing. AI apps mark these read-only.

Adds

Creates something new and never changes what is already there.

Changes

Edits or removes something that exists. AI apps may ask you before running these.

Transactions and tags

List transactions

get_budget_transactions
Reads

Search transactions

search_transactions
Reads

Add transactions

add_transactions
Adds

Edit transactions

update_transactions
Changes

Tag transactions

tag_transactions
Changes

Rename a tag

rename_tag
Changes

Analyze a tag

get_tag_analysis
Reads

Send bank transactions to review

send_bank_transactions_to_review
Changes

Categories and auto-categorization rules

List categories

get_budget_categories
Reads

Create a category

create_category
Adds

Update a category

update_category
Changes

List bank category mappings

get_category_mappings
Reads

List auto-categorization rules

get_future_rules
Reads

Test an auto-categorization rule

test_future_rule
Reads

Create an auto-categorization rule

create_future_rule
Adds

Update an auto-categorization rule

update_future_rule
Changes

Apply a rule to past transactions

apply_future_rule
Changes

Recurring bills

List recurring bills

get_recurring_rules
Reads

Check what's due

get_due_recurring
Reads

Create a recurring bill

create_recurring_rule
Adds

Update a recurring bill

update_recurring_rule
Changes

Skip a recurring payment

skip_recurring_occurrence
Changes

Month budgets

Get a month's budget

get_month_budget
Reads

Set a month's budget

set_month_budget
Changes

Reports, balances and linked banks

Analyze spending

analyze_spending
Reads

Analyze investments

analyze_investments
Reads

Estimate brokerage gains

estimate_brokerage_gain_share
Reads

Get finances

get_finances
Reads

Get net worth history

get_net_worth_history
Reads

List linked banks

get_bank_connections
Reads

Set an account balance

set_account_balance
Changes

Set a Roth contribution basis

set_contribution_basis
Changes

Purchases and receipts

Record a purchase

record_purchase
Changes

List cards

list_cards
Reads

Add a card number

add_card_number
Adds

Confirm a match

confirm_match
Changes

Reject a match

reject_match
Changes

Resolve a missing purchase

resolve_missing_purchase
Changes

List match choices

list_match_choices
Reads

List purchases to review

get_purchases_to_review
Reads

Get a receipt

get_receipt
Reads

Attach a receipt

attach_receipt
Changes

Recategorize receipt items

update_receipt_items
Changes

Edit a receipt

edit_receipt
Changes

Use receipt items for categories

use_receipt_items
Changes

Jars

List jars

get_jars
Reads

Create a jar

create_jar
Adds

Set money aside

set_aside
Adds

Take money out of a jar

take_out
Adds

Move money between jars

move_between_jars
Adds

Set a jar's balance

set_jar_balance
Changes

Assign transactions to jars

assign_transactions_to_jar
Changes

Close a jar

close_jar
Changes

Planner

List planner events

list_planner_events
Reads

Get a planner event

get_planner_event
Reads

Create a planner event

create_planner_event
Adds

Update a planner event

update_planner_event
Changes

Set a planner event's options

set_planner_options
Changes

Update a planner item

update_planner_item
Changes

Close or reopen a planner event

close_planner_event
Changes

Simulations and projections

List simulations

list_simulations
Reads

Get a simulation

get_simulation
Reads

Get a projection

get_projection
Reads

Run Monte Carlo

run_monte_carlo
Reads

Run a what-if

run_what_if_simulation
Reads

Create a simulation

create_simulation
Adds

Set up Life Budget

onboarding
Changes

Get account status

get_account_status
Reads

Editing a simulation

Add a simulation item

add_scenario_item
Adds

Update a simulation item

update_scenario_item
Changes

Set an item's scenario amount

set_item_scenario_value
Changes

Add a life event

add_life_event
Adds

Update a life event

update_life_event
Changes

Set a life event's scenarios

set_life_event_scenarios
Changes

Override a life event

set_life_event_override
Changes

Add a custom path

add_custom_path
Adds

Rename a custom path

rename_custom_path
Changes

Set a custom path's steps

set_custom_path_steps
Changes

Add a savings rule

add_savings_rule
Adds

Update a savings rule

update_savings_rule
Changes

Reorder savings rules

reorder_savings_rules
Changes

Add a scenario

add_scenario
Adds

Rename a scenario

rename_scenario
Changes

Set a scenario's tax

set_scenario_tax
Changes

Set the primary path

set_primary_path
Changes

Change a simulation setting

set_global_setting
Changes

Deletion, on your approval

Request a deletion

request_delete
Changes

Check an approval request

get_action_status
Reads

List approval requests

list_pending_actions
Reads

Help, suggestions and the roadmap

Find a feature

find_feature
Reads

Send a suggestion

submit_suggestion
Adds

Withdraw a suggestion

withdraw_suggestion
Changes

List the roadmap

list_roadmap
Reads

Vote on the roadmap

vote_on_roadmap
Changes

Limits

  • Transaction lists and spending reports cover the last 60 days unless the AI asks for a longer range, and every result says which range it used.
  • Requests are rate-limited. Monte Carlo runs also count against an hourly limit set by your plan.
  • When something can only be done in the app, the tool says so and gives your AI a link to the right screen.

Disconnect

Revoke an app in Settings → Connections. You can also remove the connector in the AI app itself.

Privacy, terms and support

Read the Privacy Policy and the Terms of Service, which cover apps you connect. Questions, or a connection you don’t recognise: support@life-budget.com.