💸 Finance Buddy · MCP server

Track income and expenses by talking to your AI assistant. Public tools work right away; the rest ask you to sign in with your Finance Buddy account (OAuth 2.1). Accounts are created in the web app.

https://mcp.demo-finances-buddy.wilsonneto.me/mcp

Connect

Claude Code
claude mcp add --transport http finance-buddy https://mcp.demo-finances-buddy.wilsonneto.me/mcp
Then ask "how is my month going?" and run /mcp → Authenticate when asked.
Claude (web & desktop)
Settings → Connectors → Add custom connector → paste the URL. The tool results show up as interactive UIs (MCP Apps).
ChatGPT
Settings → Apps & connectors → developer mode → create an app with this URL and authentication "OAuth".
MCP Inspector
npx @modelcontextprotocol/inspector
Transport "Streamable HTTP", this URL, then "Open Auth Settings" → Quick OAuth Flow.

Tools

ToolAccessWhat it does
about_finance_buddy
About Finance Buddy
publicExplains what Finance Buddy is, how to create an account, and which of its tools need the user to sign in. Works without signing in.
list_default_categories
Default categories · MCP App UI
publicShows the categories every new Finance Buddy account starts with (salary, groceries, housing...). Works without signing in. For the signed-in user's own categories, use list_categories instead.
plan_budget
Plan a 50/30/20 budget · MCP App UI
publicSplits a monthly take-home income with the 50/30/20 rule (50% needs, 30% wants, 20% savings and debt) and shows an interactive planner where the user can adjust the split. Works without signing in.
get_monthly_summary
Monthly summary · MCP App UI
sign-in · readSummarizes one month of the signed-in user's finances in an interactive dashboard: the balance carried over from previous months, income, expenses, the closing balance, spending per category (pie chart) and the last months' trend (bar and line charts).
get_my_account
My account
sign-in · readWho is signed in to Finance Buddy in this conversation: name, e-mail, currency, the app they connected through and the permissions they granted.
list_categories
List categories · MCP App UI
sign-in · readLists the signed-in user's income and expense categories (name, emoji, color, id) with this month's totals, in an interactive board where they can also add and delete categories.
list_transactions
List transactions · MCP App UI
sign-in · readLists the signed-in user's transactions of one month, newest first, with their ids, in an interactive list. Optionally only income or only expenses, or one category.
add_expense
Add an expense · MCP App UI
sign-in · writeRecords money the signed-in user spent, in one of their expense categories, and shows a receipt with its effect on the month. Call it once per expense. Categories: see list_categories; add new ones with create_category.
add_income
Add income · MCP App UI
sign-in · writeRecords money the signed-in user earned (salary, freelance work, a gift...) in one of their income categories, and shows a receipt with its effect on the month. Call it once per income.
create_category
Create a category · MCP App UI
sign-in · writeCreates an income or expense category for the signed-in user, e.g. 'Pets' 🐶 or 'Side project' 💡. Pick a fitting emoji. The color is chosen automatically unless given.
delete_category
Delete a category
sign-in · writeDeletes a category of the signed-in user. Only possible when no transaction uses it (move or delete those first). Confirm with the user first.
delete_transaction
Delete a transaction
sign-in · writeDeletes one transaction of the signed-in user, by id (see list_transactions). This cannot be undone, so confirm with the user first unless they clearly asked for it.
update_category
Edit a category · MCP App UI
sign-in · writeRenames a category of the signed-in user or changes its emoji or color. Its type (income or expense) cannot change. Only the fields you pass change.
update_transaction
Edit a transaction · MCP App UI
sign-in · writeChanges a transaction of the signed-in user: amount, category, date or description. Only the fields you pass change. Find the id with list_transactions.

Behind the scenes