list_budgets

List all YNAB budgets available to your account. This is typically the first tool to call when starting a session.

Parameters

This tool takes no parameters.

Response

Returns a list of budgets with their IDs, names, and last modified dates.

{
  "budgets": [
    {
      "id": "abc123-def456-...",
      "name": "My Budget",
      "last_modified_on": "2024-01-15T10:30:00Z"
    }
  ]
}

Example usage

What budgets do I have access to?

Next steps

After listing budgets, use sync_budget with the budget ID to load the data for analysis: