get_budgets
List all YNAB budgets in Markdown format using the MCP YNAB Server. Provides a structured overview of budgets for easy access and analysis.
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-379 (handler)The @mcp.tool()-decorated async function `get_budgets()` that implements the tool logic: fetches budgets via YNAB API and formats them as Markdown list. This decorator also serves as the tool registration in FastMCP.@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