Tax CLI 2026: File Your German Taxes Straight from the Terminal

If you are a developer or technical founder running a GmbH or a sole proprietorship in Germany, you know the friction: bookkeeping software lives in the browser, your code lives in the terminal. Norman CLI brings your tax workflows where you already work — UStVA, EÜR and corporate tax prepayments included. Norman is one of the first accounting tools to ship a real tax CLI for the German market.

What is a tax CLI?

A tax CLI is a command-line tool that lets you handle tax tasks the same way you handle infrastructure — scripted, repeatable, no UI state. The Norman tax CLI is an extension of the Norman bookkeeping CLI with tax modules; it operates on the same data as the web app and the MCP server.

What tax workflows it covers

The tax CLI covers the recurring obligations that hit freelancers and GmbHs:

• UStVA (preliminary VAT return) — generate, preview and submit monthly or quarterly returns to ELSTER
• EC sales list (Zusammenfassende Meldung) — file intra-community supplies
• EÜR / profit & loss prep — export the full SKR chart of accounts as JSON
• Tax prepayments — pull corporate tax and trade tax assessments to plan cash
• Receipt lookups — query individual receipts by ID, date or account

Installation and first steps

Install Norman CLI via npm or Homebrew and authenticate once with a personal access token from your Norman account. After that, the norman command exposes subcommands such as tax, bookkeeping and invoice. You can run it locally or bake it into container images for CI/CD.

Submit UStVA from the terminal

norman tax ustva submit --period 2026-Q1 produces the preliminary VAT return for the chosen period, runs a preview and pushes it to ELSTER — all from the shell. The CLI shares the ELSTER backend with the web app, which means identical validation, plausibility checks and submission receipts. For background, see our guide to the UStVA for GmbHs.

Prepare EÜR and year-end

For the annual income–expense statement run norman tax eur export --year 2026 --format json. The output is a complete dataset of every relevant SKR account, ready to commit to a repo, share with your Steuerberater or pipe into your own analytics. GmbHs use norman tax balance for the corresponding HGB statements.

Scripts, CI and automation

The real lever of a tax CLI is automation. A few examples teams already run:

• Pre-deadline check in CI — a nightly job calls norman tax ustva preview and posts the result to Slack so nothing surprises you on filing day.
• Warehouse syncs — weekly exports of revenue and input VAT into BigQuery or Snowflake.
• Regression on bookkeeping logic — after every deploy the EÜR is regenerated and diffed against the previous day.

Security and audit trail

Every CLI call is logged in your Norman account with token hash, command and timestamp. You can revoke tokens at any time and scope them tightly (tax:submit, tax:read, bookkeeping:write). ELSTER submissions require an additional confirmation by email or MFA by default.

Complement, not replacement, for web and MCP

The CLI does not replace the web app — it complements it. The web app is best for dashboards, deep dives and manual corrections; the CLI shines on repeatable tasks and automation. The third leg is the Norman MCP server, which exposes the same operations to AI agents. Three interfaces, one shared source of truth.

Conclusion

Norman's tax CLI is one of the few tools that lets you handle German tax obligations directly from the terminal — no click workflows, no browser context-switching, no double data entry. If your team already lives in scripts, CI/CD or DevOps workflows, tax automation belongs in the same toolchain. The Norman CLI is free and runs on macOS, Linux and Windows.