Command-line tool and TypeScript library

`bundeshaushalt`

Query the German federal budget from your terminal. bundeshaushalt is a small command-line tool over the open bundeshaushalt.de budget-data portal: fetch expenses and income by year, drill into individual budget items, economic groups or functional areas, and compare planned vs. realised figures — as clean JSON you can pipe straight into jq.

Version 0.0.7 npm GitHub API reference

Install

Needs Node.js 20 or newer. Installs the bundeshaushalt command:

npm i -g @maschinenlesbar.org/bundeshaushalt-cli

Access

No account, no API key, no configuration — install and query.

Quick start

bundeshaushalt expenses 2024

Commands

budget

Federal budget data (account: expenses | income)
expenses

Federal expenses for a year (shortcut)
income

Federal income for a year (shortcut)

All commands, arguments and options →

Claude Code skills

The bundeshaushalt plugin teaches Claude to use bundeshaushalt. Install it from the maschinenlesbar.org marketplace:

/plugin marketplace add maschinenlesbar-org/plugins
/plugin install bundeshaushalt@maschinenlesbar

/bundeshaushalt:budget-ministry-breakdown
/bundeshaushalt:budget-plan-vs-actual
/bundeshaushalt:budget-trend

What the skills answer, with real examples → Skill descriptions and requirements →

TypeScript library

@maschinenlesbar.org/bundeshaushalt-cli is also a typed API client you can import in your own code, with no runtime HTTP dependencies.

API reference → Library usage and architecture →

The tool, not the data

The data comes from the provider behind the API, under its own terms — see DATA_LICENSE.md. The code is dual-licensed AGPL-3.0-or-later or commercial — see LICENSING.md.