💸 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/mcpConnect
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
| Tool | Access | What it does |
|---|---|---|
about_finance_buddyAbout Finance Buddy | public | Explains 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_categoriesDefault categories · MCP App UI | public | Shows 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_budgetPlan a 50/30/20 budget · MCP App UI | public | Splits 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_summaryMonthly summary · MCP App UI | sign-in · read | Summarizes 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_accountMy account | sign-in · read | Who is signed in to Finance Buddy in this conversation: name, e-mail, currency, the app they connected through and the permissions they granted. |
list_categoriesList categories · MCP App UI | sign-in · read | Lists 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_transactionsList transactions · MCP App UI | sign-in · read | Lists 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_expenseAdd an expense · MCP App UI | sign-in · write | Records 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_incomeAdd income · MCP App UI | sign-in · write | Records 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_categoryCreate a category · MCP App UI | sign-in · write | Creates 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_categoryDelete a category | sign-in · write | Deletes 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_transactionDelete a transaction | sign-in · write | Deletes 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_categoryEdit a category · MCP App UI | sign-in · write | Renames 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_transactionEdit a transaction · MCP App UI | sign-in · write | Changes 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
- Preview the MCP App UIs with sample data, in a small host that speaks the MCP Apps protocol.
- Live activity: users, connected apps (OAuth clients) and what they do, in real time.
- Protected Resource Metadata (RFC 9728): which authorization server issues tokens for this server.
- This server's public key: it signs in to the identity service with it (private_key_jwt) to exchange tokens.
- /caffeinate: wakes up every app before a demo.