Take Peppol to the command line
peppol-cli brings your e-invoicing account to the terminal, next to where you're already working. Check your Peppol ID, pull invoice stats, or pipe everything as JSON into your own tools.
Free and open source. Built in Go. A single binary with zero dependencies. Works on macOS, Linux, and Windows.
Install
Homebrew, Go, or grab a binary.
Requires an e-invoice.be account. Sign up free.
Ready in three steps
From zero to your first command in under a minute. No configuration files, no setup wizards.
Install the CLI
One command via Homebrew, or grab a binary from GitHub. No runtime, no dependencies. Just a single executable.
Log in to your account
Run peppol auth. Your browser opens, you confirm, and you’re authenticated. Tokens are stored locally. Nothing ends up in your shell history.
Start using it
Check your Peppol ID with peppol me. Pull invoice volumes with peppol stats. Add --json to pipe output into scripts, dashboards, or reporting tools.
Four commands, zero complexity
peppol auth
Log in through your browser.
peppol me
View your account and Peppol ID.
peppol stats
Invoice volumes by period.
peppol stats --json
Pipe to jq. Feed into scripts.
Who uses peppol-cli
Not just for developers. Anyone who works with invoices and prefers speed over clicking through dashboards.
Customer support
A customer calls asking whether their invoice was delivered. Instead of logging into the dashboard, switching accounts, and navigating to the right page, you open your terminal.
You check their Peppol ID status and confirm the invoice was delivered. The whole thing takes ten seconds. The customer is still on the line.
Accountant
End of the month. You need to reconcile invoice volumes for the financial report. Normally this means exporting CSVs from the web app and copy-pasting numbers.
You run one command to pull last month’s sent and received counts as JSON. Import directly into Excel or your reporting tool. No manual data entry. No copy-paste errors.
Developer with Claude Code
You want your AI coding agent to check invoice status and account health as part of an automated workflow.
peppol-cli works alongside the Peppol MCP Server. The CLI handles quick lookups from your terminal. The MCP server gives your AI agent full API access. Together they cover the full range: from a quick status check to automated invoice processing.
Built to fit your workflow
A fast, single-binary CLI that works with the tools you already use. No plugins, no configuration, no surprises.
Open source
MIT licensed on GitHub. Read every line before you deploy. Report issues, submit PRs, or fork it for your own needs.
Shell completions
Bash, Zsh, Fish, and PowerShell. Tab your way through commands and flags without memorizing anything.
JSON output
All commands support --json. Pipe into jq, feed into monitoring dashboards, or process in your own scripts.
CI/CD ready
Set the PEPPOL_API_KEY environment variable for non-interactive auth. Runs unattended in GitHub Actions, GitLab CI, or any pipeline.
Cross-platform
macOS, Linux, and Windows. A single compiled binary with zero external dependencies. No runtimes to install.
Secure auth
Browser-based login flow. Tokens stored locally on your machine. Nothing sensitive ends up in config files or shell history.
CLI or API? Both.
The CLI wraps the same API. Pick what fits your workflow.
Free and open source
The CLI is free. You pay per invoice sent or received. Starting at €0.25.