You Need A Budget (YNAB) MCP

Instructions

Implementation Reference

• src/ynab_mcp_server/server.py:166-179 (handler)

  The handler logic for executing the "list-budgets" tool. It retrieves all YNAB budgets using the ynab_client and formats a markdown-style list of budget names and IDs.
  if name == "list-budgets": budgets = await ynab_client.get_budgets() if not budgets: return [types.TextContent(type="text", text="No budgets found.")] budget_list = "\n".join(f"- {b.name} (ID: {b.id})" for b in budgets) return [ types.TextContent( type="text", text=f"Here are your available budgets:\n{budget_list}", ) ]
• src/ynab_mcp_server/server.py:49-52 (registration)

  The registration of the "list-budgets" tool in the handle_list_tools() function, which lists available tools for the MCP server.
  types.Tool( name="list-budgets", description="List all available YNAB budgets", inputSchema={"type": "object", "properties": {}},
• src/ynab_mcp_server/server.py:52-52 (schema)

  The input schema for the "list-budgets" tool, which requires no parameters (empty object). Note: output is not explicitly schemed but returns TextContent.
  inputSchema={"type": "object", "properties": {}},
• src/ynab_mcp_server/server.py:31-31 (registration)

  "list-budgets" is included in the READ_ONLY_TOOLS set, allowing it in read-only mode.
  "list-budgets",