get_account_balance
Retrieve the current balance in dollars for a specific YNAB account using the account ID. Enables users to monitor financial data through the MCP YNAB Server.
Instructions
Get the current balance of a YNAB account (in dollars).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account_id | Yes |
Implementation Reference
- src/mcp_ynab/server.py:351-362 (handler)The main handler function for the 'get_account_balance' tool, decorated with @mcp.tool() for registration. It fetches the YNAB client, gets the first budget ID, retrieves the account by ID, and returns the balance in dollars.@mcp.tool() async def get_account_balance(account_id: str) -> float: """Get the current balance of a YNAB account (in dollars).""" async with await get_ynab_client() as client: accounts_api = AccountsApi(client) budgets_api = BudgetsApi(client) budgets_response = budgets_api.get_budgets() budget_id = budgets_response.data.budgets[0].id response = accounts_api.get_account_by_id(budget_id, account_id) return float(response.data.account.balance) / 1000