Bookiz
Enables ChatGPT receipt uploads through OpenAI file parameters (openai/fileParams), allowing ChatGPT to provide a download link for uploaded receipt files that Bookiz can attach and archive.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Bookiz Maak een factuur voor Klant BV: tien uur advies à 85 euro."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Nederlands, kort: Bookiz is open-source boekhouding voor eenmanszaken met weinig facturen. Je regelt facturen, bonnen en je btw-aangifte door met je eigen AI-assistent te praten. Elke belastingregel staat in deze repository, met de pagina van de Belastingdienst waar hij vandaan komt.
Why this exists
If you run a one-person service business in the Netherlands, your whole administration is a handful of invoices, a pile of receipts and four btw returns a year. Bookkeeping software is built and priced for businesses ten times that size. And every spring you pay someone a few hundred euros because you no longer trust your own numbers.
Bookiz is the opposite bet:
Small on purpose. No bank feeds, no quotes, no stock, no payroll. One small database and 24 tools.
No app to learn. It is an MCP server. Your assistant is the interface: Claude, Codex, or any other that lets you add your own MCP server.
No AI inside. The assistant reads the receipt and supplies facts. A deterministic engine applies the rules. Same input, same books.
Rules you can check. Every figure is in
rules/nl-2026.jsonwith its official source and the sentence that states it. Your bookkeeper can read along.Yours to leave. Self-host it for free, export everything as one file.
Status: 0.1, early. The engine is tested but has run no real administration yet. It calculates; it does not file with the Belastingdienst and it is not tax advice. Rules are complete for 2026; 2027 is open for booking on provisional rules until the Belastingdienst publishes the rest.
Related MCP server: manager-mcp
What you can say
You Richt mijn administratie in. Ik ben Studio Voorbeeld, KvK 12345678.
You Maak een factuur voor Klant BV: tien uur advies à 85 euro.
Bookiz Concept: € 850,00 + € 178,50 btw = € 1.028,50. Akkoord?
You Ja.
Bookiz Factuur 2026-001 is definitief. Zal ik hem versturen?
You [photo of a receipt] Lunch met de klant, zelf voorgeschoten.
Bookiz Geboekt als K2026-003: € 54,50, privé betaald. De btw op eten en
drinken in de horeca is niet aftrekbaar; 80% telt als kosten.
You Hoe sta ik ervoor?
Bookiz Btw vierde kwartaal: € 157 te betalen, vóór 31 januari.
Eén factuur staat open. Winst dit jaar: € 606,40.Your assistant writes the sentences; the numbers and the tax treatment come from Bookiz.
What it does
Invoices | Every legally required field, consecutive numbers, PDF, e-mail. A final invoice is never edited, only reversed by a credit invoice. |
Expenses | Receipts and purchase invoices, also when paid privately. Reverse-charged foreign subscriptions (rubriek 4a/4b), investments with depreciation, kilometres with your own car. |
Btw-aangifte | Per rubriek in whole euros, with the documents behind every number, the ICP list and the deadline. You copy the figures into Mijn Belastingdienst Zakelijk. |
KOR | Invoices without btw, costs including btw, turnover tracked against the € 20.000 limit. The invoice that would cross it is refused. |
Year report | Profit, kleinschaligheidsinvesteringsaftrek, zelfstandigenaftrek, startersaftrek, MKB-winstvrijstelling, and what to set aside for income tax and Zvw, also next to a job. |
Receipts | The original goes to your own mailbox or a folder. The database keeps a SHA-256 hash, not the file. |
Recurring invoices | A monthly, quarterly or yearly invoice becomes a draft on its date. Nothing is final without you. |
Switching | Coming from Moneybird, another package or a spreadsheet: take over your customers, unpaid invoices, assets and invoice numbering. Old years stay in your export. |
Export | A whole year as one JSON file, for your bookkeeper or for leaving. |
Quick start
Local, on your own computer, with nothing to install but Node.js 22.18 or newer:
git clone https://github.com/meestierolff/bookiz.git
cd bookiz
npm installAdd it to your assistant as a local MCP server.
Claude Code
claude mcp add bookiz -- node /absolute/path/to/bookiz/src/cli.tsClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"bookiz": { "command": "node", "args": ["/absolute/path/to/bookiz/src/cli.ts"] }
}
}Then say: “Richt mijn administratie in.”
Your data lives in ~/.bookiz: an embedded Postgres, your receipts and your
invoice PDFs. Back that folder up. The embedded database serves one process at
a time; a second assistant on the same folder is refused with a clear message
instead of corrupting your books. To use several assistants at once, run the
remote server.
The 24 tools
Tool | What it does |
| Where you stand: open btw periods and deadlines, unpaid invoices, missing receipts, profit, what to set aside, next actions |
| Business profile: name, address, KvK, btw-id, IBAN, KOR period, filing frequency |
| Urencriterium, startersaftrek and wage income for a year |
| Customers |
| A draft invoice, with totals and the remarks the law requires |
| Number it, lock it, make the PDF |
| E-mail the PDF to the customer, copy to you |
| Mark an invoice paid |
| Reverse a final invoice |
| By year or status |
| Invoices that repeat every 1, 3 or 12 months |
| Switch from another package: numbering, unpaid invoices, assets |
| Book a receipt or purchase invoice |
| Business kilometres with your own car |
| Archive the original document |
| Cancel a mistaken expense |
| By year, or only those without a receipt |
| The btw-aangifte for a period, per rubriek |
| Freeze a period after you filed it |
| From turnover to taxable profit, plus the tax indication |
| Everything for one year |
| The figures in use, with source and quote |
Every change is written to an audit log. Mistakes are corrected with a new document, never by editing an old one.
The rules are data
"zelfstandigenaftrek": {
"title": "Zelfstandigenaftrek",
"value": 1200,
"unit": "EUR",
"source": "https://www.belastingdienst.nl/…/zelfstandigenaftrek-2026",
"quote": "Dan is de zelfstandigenaftrek in 2026 een bedrag van € 1.200."
}rules/nl-2026.json holds all 21 rules the engine uses:
btw rates, the KOR limit, the KIA table, income tax brackets, heffingskortingen
and more. The engine refuses to calculate for a year without a rule file; it
never extrapolates.
Found a wrong figure? Open an issue or a pull request against the rule file. See rules/README.md. The rules are MIT-licensed so anyone can reuse them.
Receipts: from your phone to the archive
An MCP tool receives text, not files, and assistants differ in what they pass on:
Where you are | What happens |
Local assistant (Claude Code, Claude Desktop, Codex) | The assistant passes the file path; Bookiz reads the file |
ChatGPT with a remote server |
|
Any other assistant | The assistant reads the photo and books the expense; Bookiz returns a one-tap upload link for the original |
The last row always works. The ChatGPT route is built from OpenAI's documentation and has not been tested against ChatGPT itself.
With RECEIPT_ARCHIVE=email the original is mailed with a fixed subject:
[Bookiz bon] K2026-001 · date · vendor · amount. Self-hosted, it goes to the
address you set as archive_email (or your business email). In Cloud it
always goes to the address you sign in with, the only one Bookiz has proof is
yours. You must keep receipts for seven years, so that mailbox is now part of
your administration.
Hosting
Self-host | Cloud | Done for you | |
Price | Free | € 99 per year excl. btw, first 30 days free | € 399 per year excl. btw for the first 50, then € 499 |
What | Everything in this repository | We host it; your assistant signs in with OAuth | Cloud, plus a bookkeeper who files your btw returns and income tax return |
Available | Now | Opening soon | Presale, not live yet |
Details on boekiehouder.nl. Switching per 1 January is explained step by step on boekiehouder.nl/overstappen.
How Cloud is built
The hosted version is this same repository: src/cloud/ plus one Vercel
function. Supabase provides Postgres, accounts and the OAuth server that
assistants sign in through. Every customer has a Postgres schema of their own;
the engine is pointed at one schema and cannot name another. scripts/cloud-e2e.mjs
checks the whole flow against a deployment, including that two customers see
nothing of each other.
Remote server
For assistants that do not run on your computer:
export BOOKIZ_TOKEN=$(openssl rand -hex 24)
export PUBLIC_URL=https://bookiz.example.com
node src/cli.ts --http # or: docker compose up -dPut it behind HTTPS on port 443. Clients that can send a header (Claude Code,
Codex) use https://bookiz.example.com/mcp with Authorization: Bearer <token>.
claude.ai, ChatGPT and Grok only accept OAuth or an unauthenticated URL for
user-added servers. Until Bookiz has OAuth they can connect to
https://bookiz.example.com/mcp/<url-secret>, but only if you switch that on by
setting a second secret, BOOKIZ_URL_TOKEN. It is off by default.
That URL is a password. It can end up in logs and browser history, which is
why the MCP specification advises against secrets in URLs. So it is a separate
secret from BOOKIZ_TOKEN: you can rotate it without touching your other
clients, and it cannot be used to forge receipt or invoice links. If you use
it, turn off or redact access logging for /mcp/* on your reverse proxy.
Variable | Purpose |
| Embedded database, receipts, PDFs. Default |
| Use this Postgres instead (Supabase, Neon, your own) |
| Required with |
| Optional second secret that enables |
| Enables receipt-upload links and invoice PDF links |
| Send invoices and archive receipts by e-mail (Brevo or any SMTP) |
|
|
On Supabase, use the session pooler connection string. Bookiz creates its tables on first start and turns on row level security, so Supabase's auto-generated web API cannot read them.
Known limits
2027 is provisional. The Belastingdienst had not published 2027 figures on 16 November 2026. Invoices, expenses and btw returns work in 2027 on the rules that carry no year; the kilometre rate, the year report and the tax estimate for 2027 wait for the published figures.
Switching is new and was built from the rules, not from a real export of another package. Check the outstanding amount after importing.
Invoice basis (factuurstelsel) only; no kasstelsel, no margin schemes, no goods across borders, no private-use corrections (rubriek 1d).
The 80% rule is always used for limited-deductible costs, never the threshold.
The tax estimate covers box 1, heffingskortingen and Zvw for one person below AOW age. No partner, mortgage, box 3 or allowances.
No balance sheet: Bookiz does not know your bank balance.
The KOR is one period (
kor_sincetokor_until); leaving and joining again later is not supported. The filing frequency (month or quarter) cannot change once expenses or returns exist.A btw period that has been filed cannot be reopened. Corrections go through the next return or a suppletie, outside Bookiz.
Tested against the MCP SDK client over stdio and HTTP, on embedded and real Postgres. Not yet tested against the real claude.ai, ChatGPT and Grok apps.
Development
npm run verify # typecheck, rule-file check, tests, site build
npm test # tests only, against an in-memory Postgres
npm run web:build # static site into web/dist; prices and links in web/site.jsonBuilt with heavy use of AI coding assistants, and reviewed and tested as such: the tax examples in the tests are calculated by hand against the published tables, and every figure has to carry its source. If you find a wrong number, that is the most valuable issue you can open.
License
Engine: AGPL-3.0. Tax rules in /rules: MIT.
"Bookiz" is a name of its maintainers; a fork needs its own.
Available Tools
24 toolsattach_receiptBewijsstuk bewarenA
Store the original receipt or purchase invoice of an expense (JPG, PNG, WEBP, HEIC or PDF, max 10 MB). Pass exactly one source: file when the app hands you an uploaded file object, file_path when Bookiz runs on the same computer as you, url for an https download link, or content_base64. The file is e-mailed to the owner’s archive mailbox or written to the data folder; the database keeps only a SHA-256 hash. If you cannot pass the file, give the owner the upload link from record_expense.
Inputs: ref (required), url, file, file_path, +1 more.
create_invoiceConceptfactuurADestructive
Create a draft invoice, or replace one by passing draft_id. A draft has no number and changes nothing in the books. unit_price is excluding btw. vat_code per line: high (21%, the default), low (9%), zero, exempt, eu_reverse_charge (services to a business in another EU country, btw verlegd), outside_eu (services to a customer outside the EU). Under the KOR every line is invoiced without btw automatically. Show the result to the owner before finalize_invoice.
Inputs: lines (required), contact_id (required), note, draft_id, +3 more.
credit_invoiceFactuur crediterenADestructive
Reverse a final invoice with a creditfactuur dated today. Use this for any mistake on a final invoice, then create a correct new one.
Inputs: number (required), reason.
export_booksAdministratie exporterenARead-only
Everything for one year as JSON: business profile, invoices, expenses with receipt hashes, filed btw returns, the year report and the tax rules used. For a bookkeeper, a backup, or leaving Bookiz.
Inputs: year (required).
finalize_invoiceFactuur definitief makenADestructive
Turn a draft into a final invoice: it gets the next consecutive number, a PDF, and counts for btw and profit. This cannot be undone, only reversed with credit_invoice. Only call after the owner approved the draft.
Inputs: draft_id (required).
find_contactsRelaties zoekenARead-only
Find customers by part of their name or e-mail address. Without a query it lists all of them. Check here before creating a new contact.
Inputs: query.
get_overviewOverzichtA
The state of the books right now: open btw periods and deadlines, unpaid and overdue invoices, expenses without a receipt, profit this year, an indication of what to set aside for tax, and a list of next actions. Call this first. It also prepares a draft for any recurring invoice that has come due; it never finalizes or sends anything.
Inputs: no named parameters.
get_tax_rulesBelastingregelsARead-only
The Dutch tax figures Bookiz calculates with for a year (btw rates, KOR limit, zelfstandigenaftrek, MKB-winstvrijstelling, KIA table, kilometre rate, income tax brackets), each with its official source. Pass key for one rule including the literal quote from the source page.
Inputs: key, year.
import_opening_stateOverstappenADestructive
Take over what is still alive when the owner switches from another bookkeeping package (Moneybird, e-Boekhouden, Jortt, a spreadsheet). Use it once, after setup_business and after creating the customers with save_contact. It does NOT copy the old administration: the owner keeps an export of the old package for seven years. switch_date: the first day the books are kept here; btw returns and reports start from that day. last_invoice_number: the year and the highest sequence number already used there, so numbering continues without a gap or duplicate (not needed when switching on 1 January). open_invoices: invoices sent from the old package that are not paid yet, with their original number and amounts. They appear as outstanding and can be paid or credited here, but do not count again for turnover or btw. assets: equipment still being depreciated, at its book value on the switch date, with the original purchase price and the remaining years. If the owner uses another package with an MCP server or export, read the figures from there; never estimate them.
Inputs: switch_date (required), assets, open_invoices, last_invoice_number.
list_expensesUitgavenCRead-only
List expenses, optionally for one year or only those still missing a receipt.
Inputs: year, include_voided, missing_receipt.
list_invoicesFacturenARead-only
List invoices, optionally for one year or one status: concept, open, "te laat" (past the due date) or betaald.
Inputs: year, status.
list_recurring_invoicesPeriodieke facturenBRead-only
The invoices that repeat, with their interval and next date.
Inputs: no named parameters.
mark_vat_return_filedBtw-aangifte afsluitenADestructive
Record that the owner filed the btw-aangifte for a period. This freezes the figures and locks the period. Only call after the owner confirms the filing was actually submitted.
Inputs: period (required), filed_on.
record_expenseUitgave boekenA
Book a business purchase from a receipt or purchase invoice. amount is the total paid including btw; vat_amount is the btw printed on the document (required for Dutch suppliers, 0 if none is shown). vat_treatment: nl (Dutch supplier, the default), eu_reverse_charge (supplier in another EU country charged no btw, e.g. Google Ireland), non_eu_reverse_charge (supplier outside the EU, e.g. a US SaaS), none (no btw involved: private seller, exempt, insurance). paid_from: business account, or private when the owner paid with private money. kind: investment for a durable asset of €450 or more excluding btw (laptop, camera); it is depreciated over useful_life_years (default 5). category: kantoor (papier, postzegels, kleine apparatuur, flexplek); software (SaaS, domeinnaam, hosting, AI-abonnement); telefoon_internet (alleen het zakelijke deel); reiskosten (trein, parkeren, taxi; eigen auto via kind "mileage"); opleiding (cursus, boeken voor het vak); verzekering (beroepsaansprakelijkheid; geen arbeidsongeschiktheidsverzekering); marketing (advertenties, website, drukwerk); advies (boekhouder, jurist, Bookiz); bankkosten (zakelijke rekening, betaalprovider); representatie (relatiegeschenk, congres, zakelijke lunch die je zelf inkoopt); eten_drinken_horeca (zakelijke lunch of diner in restaurant of café); overig (alles wat nergens anders past). Refuses a likely duplicate unless allow_duplicate is true. Afterwards, store the original with attach_receipt.
Inputs: date (required), amount (required), vendor (required), kind, +8 more.
record_mileageZakelijke kilometersA
Book business kilometres driven with the owner’s private car at the fixed rate per kilometre. Not for a company car, and not for commuting to an employer.
Inputs: km (required), date (required), description (required).
register_paymentBetaling registrerenADestructive
Mark a final invoice as paid on a date (default today). Pass paid_on: null to undo a mistake.
Inputs: number (required), paid_on.
save_contactRelatie opslaanADestructive
Create a customer (omit id) or update one (pass id). Name and address are required on an invoice. vat_id is required to invoice an EU business with btw verlegd. country is an ISO code such as NL, BE, DE, US.
Inputs: id, city, name, email, +5 more.
save_recurring_invoicePeriodieke factuurADestructive
Create (omit id), change or stop (active: false) an invoice that repeats every 1, 3 or 12 months, for example a monthly retainer. On each date Bookiz prepares a draft, never a final invoice; get_overview reports the draft and the owner approves it as usual.
Inputs: id, note, lines, active, +3 more.
send_invoiceFactuur versturenA
E-mail a final invoice as PDF to the customer, with a copy to the owner. Needs SMTP on the server. Ask the owner before sending; this leaves the building.
Inputs: number (required), to, message.
setup_businessBedrijfsgegevensADestructive
Create or update the business profile. Only pass fields that change. Name, address, KvK-nummer, IBAN and (unless the KOR applies) btw-id are legally required on invoices. kor_since is the first day of the kleineondernemersregeling (omit when the business charges btw); kor_until is the last day it applied, set only when the owner left the KOR. Neither may change how documents already booked are treated.
Inputs: city, iban, name, email, +10 more.
set_year_factsJaargegevensBDestructive
Facts about a tax year that documents cannot show. hours_criterion: did the owner work at least 1,225 hours in the business (needed for zelfstandigenaftrek). starter: entitled to startersaftrek. wage_income: gross wage from employment that year, used only to estimate how much tax to set aside. Ask the owner; do not assume.
Inputs: year (required), starter, wage_income, hours_criterion.
vat_returnBtw-aangifteARead-only
The btw-aangifte for a period (2026-Q4 or 2026-11), per rubriek in whole euros exactly as the form of Mijn Belastingdienst Zakelijk asks, with the documents behind every number, the ICP list and the deadline. Without a period it picks the oldest one that still has to be filed. The owner copies the figures into the form; Bookiz does not submit.
Inputs: period.
void_expenseUitgave laten vervallenADestructive
Cancel an expense that was booked by mistake. It stays visible with the reason. Not possible once its btw period has been filed.
Inputs: ref (required), reason (required).
year_reportJaaroverzichtBRead-only
Profit and loss for a year and the steps to taxable profit: omzet, kosten per category, afschrijvingen, kleinschaligheidsinvesteringsaftrek, zelfstandigenaftrek, startersaftrek, MKB-winstvrijstelling, plus an indication of income tax and Zvw to set aside. These are the figures for "winst uit onderneming" in the aangifte inkomstenbelasting.
Inputs: year.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 24 tools
Most tools map to distinct resources and actions, and the detailed descriptions clarify invoice, expense, VAT, contact, and reporting workflows. However, get_overview, year_report, list_invoices, and list_expenses all surface financial state or profit, so an agent may sometimes need to choose carefully among them.
The set is mostly snake_case verb_noun (create_invoice, record_expense, list_invoices, save_contact), with predictable resource suffixes. A few tools are noun-only (vat_return, year_report) and save vs create is used for upserts, but the convention remains readable and mostly consistent.
At 24 tools, this sits at the top of the rubric's 16-25 'heavy' band. The bookkeeping domain is broad enough to justify many operations, but the surface still feels large rather than tightly scoped.
Core workflows are well covered: contacts, invoice lifecycle including recurring invoices, payments and credits, expenses with receipts and mileage, VAT returns, annual reports, export, and tax rules. Gaps are modest, such as no bank reconciliation/import and limited direct editing or detail retrieval, but agents can work around them.
Maintenance
Related MCP Connectors
AI bookkeeper for Swiss small companies: books invoices, reconciles the bank, keeps VAT current.
Double entry accounting run by your own AI: books, VAT figures, invoices, month close (UK, DE, AT).
Create, send and track invoices from a conversation in Claude, ChatGPT or any MCP client that supports OAuth. Draft an invoice from one sentence or from last month's invoice for the same client, finalize it, email it to your client and send payment reminders for overdue ones. See revenue by month and by client, download PDFs and e-invoices (ZUGFeRD, XRechnung), and export DATEV packages for your tax advisor. Invoices follow the tax rules of 25 countries, including reverse charge and the small-business VAT exemption. New invoices are drafts, and nothing is emailed until you ask. Pay per invoice with no subscription: the first invoice is free.
Query your books, company data, business health, and ship invoices from your AI assistant.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage business operations including invoicing, WooCommerce syncing, expense tracking, POS, inventory, and team management through natural language.12 npm2MIT
- AlicenseBqualityBmaintenanceEnables AI assistants to query and manage self-hosted accounting data—invoices, balances, and books—through natural language, with read-only tools by default and optional scoped write operations.3027 PyPI1AGPL 3.0
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to serve as the only interface for consultant and small-agency billing, recording clients, billable work, expenses and payments, and drafting and issuing invoices. It enforces billing rules server-side, numbering invoices, calculating totals, requiring exact-total approval before issue, and never rewriting an issued invoice.1MIT
- AlicenseAqualityCmaintenanceEnables an AI assistant to read Portuguese invoices and receipts, file them by tax year, and book them into an Excel or Google Sheets workbook. It works out the boxes of the quarterly IVA return, tracks IRS and Segurança Social totals, and reports what documents are still missing.16MIT