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 2026At a glance
Server address
https://api.life-budget.com/mcp/Transport
Sign-in
Tools
Plans
Connect an AI app
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.
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.
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.
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:
Changes nothing. AI apps mark these read-only.
Creates something new and never changes what is already there.
Edits or removes something that exists. AI apps may ask you before running these.
Transactions and tags
List transactions
get_budget_transactionsSearch transactions
search_transactionsAdd transactions
add_transactionsEdit transactions
update_transactionsTag transactions
tag_transactionsRename a tag
rename_tagAnalyze a tag
get_tag_analysisSend bank transactions to review
send_bank_transactions_to_reviewCategories and auto-categorization rules
List categories
get_budget_categoriesCreate a category
create_categoryUpdate a category
update_categoryList bank category mappings
get_category_mappingsList auto-categorization rules
get_future_rulesTest an auto-categorization rule
test_future_ruleCreate an auto-categorization rule
create_future_ruleUpdate an auto-categorization rule
update_future_ruleApply a rule to past transactions
apply_future_ruleRecurring bills
List recurring bills
get_recurring_rulesCheck what's due
get_due_recurringCreate a recurring bill
create_recurring_ruleUpdate a recurring bill
update_recurring_ruleSkip a recurring payment
skip_recurring_occurrenceMonth budgets
Get a month's budget
get_month_budgetSet a month's budget
set_month_budgetReports, balances and linked banks
Analyze spending
analyze_spendingAnalyze investments
analyze_investmentsEstimate brokerage gains
estimate_brokerage_gain_shareGet finances
get_financesGet net worth history
get_net_worth_historyList linked banks
get_bank_connectionsSet an account balance
set_account_balanceSet a Roth contribution basis
set_contribution_basisPurchases and receipts
Record a purchase
record_purchaseList cards
list_cardsAdd a card number
add_card_numberConfirm a match
confirm_matchReject a match
reject_matchResolve a missing purchase
resolve_missing_purchaseList match choices
list_match_choicesList purchases to review
get_purchases_to_reviewGet a receipt
get_receiptAttach a receipt
attach_receiptRecategorize receipt items
update_receipt_itemsEdit a receipt
edit_receiptUse receipt items for categories
use_receipt_itemsJars
List jars
get_jarsCreate a jar
create_jarSet money aside
set_asideTake money out of a jar
take_outMove money between jars
move_between_jarsSet a jar's balance
set_jar_balanceAssign transactions to jars
assign_transactions_to_jarClose a jar
close_jarPlanner
List planner events
list_planner_eventsGet a planner event
get_planner_eventCreate a planner event
create_planner_eventUpdate a planner event
update_planner_eventSet a planner event's options
set_planner_optionsUpdate a planner item
update_planner_itemClose or reopen a planner event
close_planner_eventSimulations and projections
List simulations
list_simulationsGet a simulation
get_simulationGet a projection
get_projectionRun Monte Carlo
run_monte_carloRun a what-if
run_what_if_simulationCreate a simulation
create_simulationSet up Life Budget
onboardingGet account status
get_account_statusEditing a simulation
Add a simulation item
add_scenario_itemUpdate a simulation item
update_scenario_itemSet an item's scenario amount
set_item_scenario_valueAdd a life event
add_life_eventUpdate a life event
update_life_eventSet a life event's scenarios
set_life_event_scenariosOverride a life event
set_life_event_overrideAdd a custom path
add_custom_pathRename a custom path
rename_custom_pathSet a custom path's steps
set_custom_path_stepsAdd a savings rule
add_savings_ruleUpdate a savings rule
update_savings_ruleReorder savings rules
reorder_savings_rulesAdd a scenario
add_scenarioRename a scenario
rename_scenarioSet a scenario's tax
set_scenario_taxSet the primary path
set_primary_pathChange a simulation setting
set_global_settingDeletion, on your approval
Request a deletion
request_deleteCheck an approval request
get_action_statusList approval requests
list_pending_actionsHelp, suggestions and the roadmap
Find a feature
find_featureSend a suggestion
submit_suggestionWithdraw a suggestion
withdraw_suggestionList the roadmap
list_roadmapVote on the roadmap
vote_on_roadmapLimits
- 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.
