About Budgetbakers
Budgetbakers is an MCP server in the Blockchain category: mCP server for BudgetBakers Wallet API — gives Claude access to accounts, transactions, and spending analytics.
Install
claude mcp add budgetbakers -- npx -y budgetbakers-mcpnpx -y budgetbakers-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (8)
cashflow_summaryIncome, expenses, and net cashflow for a date range
Parameters not published.
get_accountsList all accounts with balances. Filters: `currency`, `accountType`
Parameters not published.
get_categoriesIncome/expense categories. Filter: `name`
Parameters not published.
get_labelsUser-defined tags. Filter: `name`
Parameters not published.
get_transactionFull details of a single transaction by `id`
Parameters not published.
search_transactionsSearch transactions. Requires `accountId`. Filters: dates, category, payee, amount
Parameters not published.
spending_by_categorySpending grouped by category for a date range
Parameters not published.
top_merchantsTop merchants by spending for a date range
Parameters not published.
Ask AI
Ask AI about Budgetbakers
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
BudgetBakers MCP Server
MCP server for integrating Claude with the BudgetBakers Wallet API. Gives Claude access to financial data: accounts, transactions, categories, and spending analytics.
Quick start
Add to ~/.claude/settings.json (or Claude Desktop config):
{
"mcpServers": {
"budgetbakers": {
"command": "npx",
"args": ["-y", "budgetbakers-mcp"],
"env": {
"BUDGETBAKERS_API_TOKEN": "<your-token>"
}
}
}
}
You can get the API token from BudgetBakers Wallet settings.
Tools
| Tool | Description |
|---|---|
get_accounts |
List all accounts with balances. Filters: currency, accountType |
get_categories |
Income/expense categories. Filter: name |
get_labels |
User-defined tags. Filter: name |
search_transactions |
Search transactions. Requires accountId. Filters: dates, category, payee, amount |
get_transaction |
Full details of a single transaction by id |
spending_by_category |
Spending grouped by category for a date range |
cashflow_summary |
Income, expenses, and net cashflow for a date range |
top_merchants |
Top merchants by spending for a date range |
accountIdis required for transactions and analytics tools. Callget_accountsfirst to get it.
Example prompts
- "Show my accounts and balances"
- "How much did I spend in February?"
- "What do I spend the most money on?"
- "Top 5 merchants this month"
- "Find all transactions at Starbucks in January"
Development
git clone https://github.com/vmrchnk/budgetbakers-mcp.git
cd budgetbakers-mcp
npm install
npm run build
To use the local build instead of the npm package:
{
"mcpServers": {
"budgetbakers": {
"command": "node",
"args": ["/path/to/budgetbakers-mcp/build/index.js"],
"env": {
"BUDGETBAKERS_API_TOKEN": "<your-token>"
}
}
}
}
Technical details
- TypeScript, ES2022, Node16 modules
- Dependencies:
@modelcontextprotocol/sdk,zod - Supports
agentHints=true— API returns hints about pagination, rate limits, etc. - Automatic pagination via hint-provided URLs
- Analytics tools aggregate data server-side (API has no analytics endpoints)
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.