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",