get_budgets
Retrieve all YNAB budgets in Markdown format to view and manage your financial plans.
Instructions
List all YNAB budgets in Markdown format.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/mcp_ynab/server.py:364-380 (handler)The handler function for the 'get_budgets' tool. It is registered via the @mcp.tool() decorator. Fetches the list of budgets using the YNAB BudgetsApi and formats them as a Markdown string.
@mcp.tool() async def get_budgets() -> str: """List all YNAB budgets in Markdown format.""" async with await get_ynab_client() as client: budgets_api = BudgetsApi(client) budgets_response = budgets_api.get_budgets() budgets_list = budgets_response.data.budgets markdown = "# YNAB Budgets\n\n" if not budgets_list: markdown += "_No budgets found._" else: for budget in budgets_list: b = budget.to_dict() markdown += f"- **{b.get('name', 'Unnamed Budget')}** (ID: {b.get('id')})\n" return markdown