Freelancer Toolbox

A collection of tools and documentation for freelancers to manage invoicing, time tracking, accounting, and tax preparation.

Getting Started

New to freelancing? Start here:

• Getting Started Guide - Set yourself up as a contractor (tax registration, insurance, banking)
• Country Guides - Country-specific guidance for Germany, UK, Switzerland, and more

Workflows

Step-by-step guides for common tasks:

• Monthly Invoicing - Export time tracking data and generate invoices
• Tax Preparation - Year-end tax calculation and document gathering

Tools

Time Tracking

Tool	Description
harvest-exporter	Export timesheets from Harvest with currency conversion
kimai-exporter	Export time entries from Kimai

Invoicing & Accounting

Tool	Description
sevdesk-cli	CLI for SevDesk - manage vouchers, tax rules, transactions
sevdesk-api	Python client library for SevDesk API
sevdesk-invoicer	Generate SevDesk invoices, import Wise transactions, estimate taxes
quipu	Generate invoices in Quipu

Banking

Tool	Description
wise-exporter	Download bank statements from Wise

Document Management

Tool	Description
paperless-cli	CLI for Paperless-ngx - document management

Quick Start

Setup

cp .envrc.local-template .envrc.local
# Edit .envrc.local with your API tokens

Generate an Invoice

1. Export your time tracking data:

harvest-exporter --format json > harvest.json

2. Generate the invoice:

sevdesk-invoicer --customer "CUSTOMER_ID" harvest.json

See Monthly Invoicing Workflow for the complete guide.

Configuration

Environment Variables

Variable	Description
HARVEST_ACCOUNT_ID	Harvest account ID
HARVEST_ACCESS_TOKEN	Harvest API token (get one here)
SEVDESK_API_TOKEN	SevDesk API token
WISE_API_TOKEN	Wise API token
WISE_PRIVATE_KEY	Path to RSA private key for Wise 2FA
WISE_PROFILE	Wise business profile ID
PAPERLESS_URL	Paperless-ngx instance URL
PAPERLESS_TOKEN	Paperless API token

API References

• Harvest API v2
• Wise API
• SevDesk API

License

MIT