frihet

Official CLI for Frihet. Manage your business from the terminal.

Install

npm install -g frihet

Or use directly:

npx frihet status

Setup

frihet login
# Enter your API key from https://app.frihet.io/settings/security

Or set the environment variable:

export FRIHET_API_KEY=fri_...

Commands

Business status

frihet status
# Revenue:   EUR 15,200.00
# Expenses:  EUR 3,400.00
# Net:       EUR 11,800.00
# Overdue:   4 invoices (EUR 3,200.00)

Invoices

# List invoices
frihet invoices list
frihet invoices list --status overdue
frihet invoices list --from 2026-01-01 --to 2026-03-31

# Create invoice
frihet invoices create --client "Acme Corp" --item "Consulting,10,150" --tax 21

# Create and send immediately
frihet invoices create --client "Acme" --item "Design,5,200" --send [email protected]

# View details
frihet invoices get inv_abc123

# Mark as paid
frihet invoices paid inv_abc123

# Send by email
frihet invoices send inv_abc123 --to [email protected]

Expenses

# List expenses
frihet expenses list
frihet expenses list --from 2026-03-01

# Create expense
frihet expenses create --desc "Adobe Creative Cloud" --amount 59.99 --category software

Clients

# List clients
frihet clients list
frihet clients list -q "Acme"

# Create client
frihet clients create --name "Acme Corp" --email [email protected] --tax-id B12345678

Environment variables

| Variable | Description | |----------|-------------| | FRIHET_API_KEY | API key (overrides ~/.frihet/config.json) | | FRIHET_API_URL | Custom API base URL |

Links

• SDK
• API Documentation
• MCP Server

License

MIT