bokio-mcp
Connect to a Bokio company to inspect, download, and compute accounting data, with read-only tools by default and write tools hidden unless BOKIO_ALLOW_WRITES is enabled.
Read company info, fiscal years, chart of accounts, account details, journal entries, invoices, credit notes, suppliers, supplier invoices, customers, items, bank payments, and uploads.
Download SIE exports, invoice and credit-note PDFs, and uploaded files to a controlled save path.
Compute account balances, account ledgers, VAT summaries, profit and loss, open items, possible duplicate bookings, and bank reconciliation from SIE data.
Use raw GET access for Bokio API paths not covered by dedicated tools.
If writes are enabled, create/update/delete or publish/record invoices, credit notes, suppliers, supplier invoices, customers, items, journal entries, and uploads; bank-payment creation remains unavailable.
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., "@bokio-mcp list the last 10 journal entries"
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.
bokio-mcp
An MCP server for the Bokio accounting API. Connect it to Claude or any other MCP client and you can ask about your books in plain language: what is on the bank account at a given date, which customer invoices are still unpaid, what the VAT for last quarter adds up to, whether anything has been booked twice.
It is built for small companies and consultants who keep their own books in Bokio. By default it only reads: write tools stay hidden until you turn them on, so it is safe to point at live accounting data.
What it covers
The server wraps the Bokio API for one company: journal entries, invoices, credit notes, customers, suppliers, supplier invoices, items, uploads, bank payments (read only), chart of accounts, fiscal years and the SIE export.
It also has computed tools that work on the SIE export: balances at a date, a ledger for one account, VAT and profit and loss for a period, open items, possible double bookings, and reconciliation against a bank statement. The server does that arithmetic in whole öre and hands the client finished numbers, so the same question gives the same answer every time.
Related MCP server: sevdesk-mcp
Before you start
You need three things:
A Bokio private integration token. In Bokio, go to Integrations, create an integration and copy the token. Bokio allows 5,000 requests per company per month and 200 per minute.
Your company id. It is in the Bokio URL:
.../companies/<companyId>/....Node.js 22 or later.
Install
The server runs straight from npm, with no clone needed. It speaks MCP over stdio, so your MCP client starts it for you. Its MCP Registry name is io.github.diblaze/bokio-mcp.
Using an AI agent? Paste https://raw.githubusercontent.com/diblaze/bokio-mcp/main/LLM.md into it and ask it to install bokio-mcp.
Claude Code
claude mcp add --transport stdio --scope user \
--env BOKIO_TOKEN=your_token \
--env BOKIO_COMPANY_ID=your_company_id \
bokio -- npx -y bokio-mcpClaude Desktop and other MCP clients
Add this to the client's mcpServers config (for Claude Desktop, claude_desktop_config.json):
{
"mcpServers": {
"bokio": {
"command": "npx",
"args": ["-y", "bokio-mcp"],
"env": {
"BOKIO_TOKEN": "your_token",
"BOKIO_COMPANY_ID": "your_company_id",
"BOKIO_DOWNLOAD_DIR": "/path/for/downloads",
"BOKIO_ALLOW_WRITES": ""
}
}
}
}Keep the token out of files you commit or share. Clients that support it, such as Claude Code, can read ${BOKIO_TOKEN} from your shell environment instead.
Configuration
Variable | Required | Purpose |
| yes, when a tool is called | Private Bearer token |
| default company | Used when a tool call leaves out |
| no |
|
| recommended | Where SIE, PDF and upload downloads are saved. Without it, downloads go to the server's working directory, and they are rejected when that is |
| no | Defaults to |
Reading and writing
Set BOKIO_ALLOW_WRITES=1 when you want the server to create or change things in Bokio, and leave it empty the rest of the time. Write tools are marked (write) below.
Bank payments are read only on purpose. Creating one would move money once it is signed with BankID, so the server does not offer it.
Tools
Company and ledger: bokio_company_info, bokio_list_fiscal_years, bokio_get_fiscal_year, bokio_chart_of_accounts, bokio_get_account, bokio_download_sie
Journal: bokio_list_journal_entries (from/to/query), bokio_get_journal_entry, bokio_create_journal_entry (write), bokio_reverse_journal_entry (write)
Invoices: bokio_list_invoices, bokio_get_invoice, bokio_create_invoice (write), bokio_update_invoice (write), bokio_delete_invoice (write), bokio_publish_invoice (write), bokio_record_invoice (write), bokio_create_invoice_payment (write), bokio_download_invoice (PDF), bokio_list_invoice_payments, bokio_list_invoice_settlements, bokio_create_invoice_settlement (write)
Credit notes: bokio_list_credit_notes, bokio_get_credit_note, bokio_download_credit_note (PDF), bokio_create_credit_note (write, from an invoice), bokio_update_credit_note (write), bokio_publish_credit_note (write), bokio_record_credit_note (write), bokio_delete_credit_note (write, drafts only)
Suppliers: bokio_list_suppliers, bokio_get_supplier, bokio_create_supplier (write), bokio_update_supplier (write)
Supplier invoices: bokio_list_supplier_invoices, bokio_get_supplier_invoice, bokio_create_supplier_invoice (write), bokio_update_supplier_invoice (write)
Customers: bokio_list_customers, bokio_get_customer, bokio_create_customer (write), bokio_update_customer (write)
Items: bokio_list_items, bokio_get_item, bokio_create_item (write), bokio_update_item (write)
Uploads: bokio_list_uploads, bokio_get_upload, bokio_upload_file (write), bokio_download_upload
Bank payments: bokio_list_bank_payments, bokio_get_bank_payment. Bokio only returns payments created by the same integration.
Computed: bokio_account_balances, bokio_account_ledger, bokio_find_duplicates, bokio_reconcile_bank (pass your bank statement as {date, amount, text} rows), bokio_vat_summary (account totals, not mapped to VAT-return boxes), bokio_profit_and_loss, bokio_open_items (also works when revenue is booked as manual journal entries instead of through the invoice module). Each call downloads the SIE export for the fiscal years it needs, one request per year. Amounts are in ledger sign, debit positive and credit negative, and a verification cancels out against its Annullering av … reversal.
Anything else: bokio_raw_get sends a GET to any Bokio path.
Limits
Journal entries are double entry, so the debit total must equal the credit total.
Tag groups, projects, journal-entry comments and tags, and invoice attachments have no tools yet. Read them with
bokio_raw_get.Bokio's API reference is at https://docs.bokio.se and the OpenAPI specs at https://github.com/bokio/bokio-api.
Contributing
Issues and pull requests are welcome. CONTRIBUTING.md covers building from source, running the tests and the smoke check, and what a pull request needs. In short: commits follow Conventional Commits, pnpm install sets up git hooks that check formatting and commit messages, and CI has to pass on Node 22 and 24 before a maintainer reviews. Adding a tool has its own checklist in the same file.
Report security issues privately as described in SECURITY.md, not in a public issue. Release notes are in CHANGELOG.md.
License
Available Tools
37 toolsbokio_account_balancesARead-only
Compute the opening balance, movement and balance per account at a date from the SIE export. Use it for what is on an account at a date; bokio_account_ledger shows the individual lines. Amounts in ledger sign: debit positive, credit negative.
Inputs: date, accounts, companyId, fiscalYearId. Returns: date, balances
bokio_account_ledgerARead-only
List the postings on one account between two dates with a running balance, ordered by date, series and number, computed from the SIE export. Annulled verifications are kept and flagged cancelled; bokio_list_journal_entries lists whole verifications instead. Amounts in ledger sign: debit positive, credit negative.
Inputs: to (required), from (required), account (required), companyId. Returns: to, from, name, lines, +3 more
bokio_chart_of_accountsARead-only
List the company's BAS chart of accounts: account numbers with names. Use it to find the account number the ledger and balance tools take; bokio_get_account reads a single account.
Inputs: query, companyId.
bokio_company_infoARead-only
Get the Bokio company's own details, such as its name and organisation number. Use it to confirm which company the token and companyId point at.
Inputs: companyId.
bokio_download_credit_noteARead-only
Download a published credit note as a PDF file to savePath. Returns the written path and byte count.
Inputs: savePath (required), creditNoteId (required), companyId.
bokio_download_invoiceARead-only
Download a published invoice as a PDF file to savePath. Returns the written path and byte count; bokio_get_invoice returns the invoice data instead.
Inputs: savePath (required), invoiceId (required), companyId.
bokio_download_sieARead-only
Download the raw SIE 4 export of one fiscal year to savePath, or return its first 4,000 characters as text when savePath is omitted. For balances, ledgers, VAT or profit and loss use the computed tools, which read this export themselves and do the arithmetic.
Inputs: fiscalYearId (required), savePath, companyId.
bokio_download_uploadARead-only
Download an uploaded file's content to savePath. Returns the written path and byte count; bokio_get_upload returns its metadata.
Inputs: savePath (required), uploadId (required), companyId.
bokio_find_duplicatesARead-only
Find possible double bookings in the SIE export: lines with the same account and amount from different verifications within windowDays of each other. Annulled verifications are skipped; to check against a bank statement use bokio_reconcile_bank. Amounts in ledger sign: debit positive, credit negative.
Inputs: to (required), from (required), account, companyId, +1 more. Returns: groups
bokio_get_accountARead-only
Get one account from the BAS chart of accounts by number. For its balance or postings use bokio_account_balances or bokio_account_ledger.
Inputs: account (required), companyId.
bokio_get_bank_paymentARead-only
Get one bank payment by id. Bokio returns only payments created by this integration, and creating them is deliberately not exposed.
Inputs: bankPaymentId (required), companyId.
bokio_get_credit_noteARead-only
Get one credit note by id, as Bokio returns it. Use bokio_download_credit_note for the PDF.
Inputs: creditNoteId (required), companyId.
bokio_get_customerBRead-only
Get one customer by id, as Bokio returns it. Their invoices are listed by bokio_list_invoices.
Inputs: customerId (required), companyId.
bokio_get_fiscal_yearARead-only
Get one fiscal year by id, with its start and end dates. bokio_list_fiscal_years returns all of them in one call.
Inputs: fiscalYearId (required), companyId.
bokio_get_invoiceARead-only
Get one customer invoice by id, as Bokio returns it. Use bokio_download_invoice for the PDF and bokio_list_invoice_payments for its payments.
Inputs: invoiceId (required), companyId.
bokio_get_itemARead-only
Get one item (artikel) by id, as Bokio returns it.
Inputs: itemId (required), companyId.
bokio_get_journal_entryARead-only
Get one journal entry (verifikation) by id, as Bokio returns it. To find entries by date use bokio_list_journal_entries.
Inputs: journalEntryId (required), companyId.
bokio_get_supplierARead-only
Get one supplier by id, as Bokio returns it. Their invoices are listed by bokio_list_supplier_invoices.
Inputs: supplierId (required), companyId.
bokio_get_supplier_invoiceARead-only
Get one supplier invoice by id, as Bokio returns it. An attached file downloads with bokio_download_upload.
Inputs: supplierInvoiceId (required), companyId.
bokio_get_uploadARead-only
Get one upload's metadata by id. bokio_download_upload fetches the file itself.
Inputs: uploadId (required), companyId.
bokio_list_bank_paymentsARead-only
List bank payments with paging. Bokio returns only payments created by this integration, and creating them is deliberately not exposed.
Inputs: page, query, pageSize, companyId. Returns: items, totalItems, totalPages, currentPage
bokio_list_credit_notesARead-only
List credit notes (kreditfakturor) with paging and a raw query filter. Customer invoices are listed by bokio_list_invoices.
Inputs: page, query, pageSize, companyId. Returns: items, totalItems, totalPages, currentPage
bokio_list_customersARead-only
List customers with paging and a raw query filter. Use bokio_get_customer for one customer's details.
Inputs: page, query, pageSize, companyId. Returns: items, totalItems, totalPages, currentPage
bokio_list_fiscal_yearsARead-only
List the company's fiscal years with their ids and start and end dates. The ids feed bokio_download_sie and the fiscalYearId of bokio_account_balances.
Inputs: companyId. Returns: items, totalItems, totalPages, currentPage
bokio_list_invoice_paymentsARead-only
List the payments registered on one invoice, with paging. Fees and currency differences are listed by bokio_list_invoice_settlements.
Inputs: invoiceId (required), page, query, pageSize, +1 more. Returns: items, totalItems, totalPages, currentPage
bokio_list_invoicesARead-only
List customer invoices with paging and a raw query filter. Revenue booked as journal entries is not listed here; use bokio_account_ledger or bokio_open_items for that.
Inputs: page, query, pageSize, companyId. Returns: items, totalItems, totalPages, currentPage
bokio_list_invoice_settlementsARead-only
List the settlements on one invoice: currency differences, bank fees and payment-service fees. Payments are listed by bokio_list_invoice_payments.
Inputs: invoiceId (required), page, query, pageSize, +1 more. Returns: items, totalItems, totalPages, currentPage
bokio_list_itemsARead-only
List items (artiklar), the products and services used on invoice lines, with paging. Use bokio_get_item for one item.
Inputs: page, query, pageSize, companyId. Returns: items, totalItems, totalPages, currentPage
bokio_list_journal_entriesARead-only
List journal entries (verifikationer) with paging, optionally between from and to or narrowed by a raw query filter. For the postings on one account use bokio_account_ledger.
Inputs: to, from, page, query, +2 more. Returns: items, totalItems, totalPages, currentPage
bokio_list_supplier_invoicesARead-only
List supplier invoices (leverantörsfakturor) with paging and a raw query filter. For unpaid supplier debt by age use bokio_open_items on account 2440.
Inputs: page, query, pageSize, companyId. Returns: items, totalItems, totalPages, currentPage
bokio_list_suppliersARead-only
List suppliers (leverantörer) with paging and a raw query filter. Their invoices are listed by bokio_list_supplier_invoices.
Inputs: page, query, pageSize, companyId. Returns: items, totalItems, totalPages, currentPage
bokio_list_uploadsARead-only
List uploaded files and receipts (kvitton) with paging. Use bokio_download_upload for a file's content.
Inputs: page, query, pageSize, companyId. Returns: items, totalItems, totalPages, currentPage
bokio_open_itemsARead-only
List unpaid items on a ledger account at asOf, matching each payment to the earliest unpaid posting of the same amount (FIFO, exact öre). Returns open items with their age in days, payments that matched nothing, the balance, and the oldest loaded year's opening balance as one unitemised amount. Amounts in ledger sign: debit positive, credit negative.
Inputs: asOf, account, companyId, lookbackYears. Returns: asOf, open, account, balance, +2 more
bokio_profit_and_lossARead-only
Sum the result accounts (BAS classes 3-8) for a period, grouped by class or by account, with result = negated total so that profit is positive. For balance-sheet accounts use bokio_account_balances. Amounts in ledger sign: debit positive, credit negative.
Inputs: to (required), from (required), groupBy, companyId. Returns: to, from, rows, result
bokio_raw_getARead-only
Send a GET to any Bokio API path that no other tool covers; {companyId} in the path is replaced with the company id. Returns the response body.
Inputs: path (required), params, companyId.
bokio_reconcile_bankARead-only
Match bank statement rows against one ledger account by exact amount within toleranceDays, reading the SIE export itself; rows in date order each take the earliest unmatched ledger line within toleranceDays, each ledger line once. Returns matched pairs, unmatched rows on both sides, suspected duplicate ledger lines and totals, where difference = ledger minus bank. Amounts in ledger sign: debit positive, credit negative.
Inputs: rows (required), account, companyId, toleranceDays. Returns: to, from, account, matched, +6 more
bokio_vat_summaryARead-only
Sum the VAT accounts (2610-2659) and sales accounts (3000-3999) for a period, with outputVat (negated 2610-2639), inputVat (2640-2649) and netVat = output minus input, positive when VAT is to pay. These are account totals and do not map to tax-return boxes. Amounts in ledger sign: debit positive, credit negative.
Inputs: to (required), from (required), companyId. Returns: to, from, netVat, accounts, +2 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 37 tools
Each tool has a clearly distinct resource/action, and descriptions explicitly cross-reference alternatives (e.g. list vs get, payments vs settlements, balances vs ledger). Even the computed accounting tools have well-delineated purposes, and raw_get is scoped to paths not covered elsewhere.
All tools share the bokio_ prefix and use predictable verb_noun naming for action tools (list_, get_, download_, find_, reconcile_). A few tools are noun phrases without a verb (company_info, chart_of_accounts, account_balances, vat_summary, profit_and_loss), which is a minor inconsistency.
At 37 tools, the surface is heavy for an accounting integration and includes redundant single-item getters alongside list tools. While the domain is broad, several tools could be consolidated or are only useful for narrow analysis tasks.
The server provides broad read coverage plus computed reports and downloads, but it lacks create/update/delete operations for invoices, customers, suppliers, items, and journal entries. raw_get only covers uncovered GET endpoints, so many write workflows are unavailable.
Maintenance
Related MCP Connectors
Read Bokio accounts, invoices and customers; create drafts and journal entries.
Fortnox accounting for one company: invoices, reports, ledger, documents. Read-only until enabled.
Read invoices, journals and accounts; create customers, items and unposted invoices in Briox.
Read Ambrook books: P&L, balance sheets, unpaid invoices, bills due, and transactions. Read-only.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to read and write Cynco accounting data, including querying books, creating invoices, reconciling transactions, and generating financial reports.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables interaction with the sevDesk accounting API for managing contacts, invoices, credit notes, orders, vouchers, transactions, and parts.24 npm1MIT
- AlicenseAqualityDmaintenanceConnects AI assistants to the Danish accounting platform Billy (billy.dk) for managing invoices, journal entries, balances, and receipts, with built-in human approval for all write operations.4044 npm1MIT
- AlicenseAqualityDmaintenanceEnables MCP clients to read and write Bokio accounting data for one company through 85 tools covering invoices, customers, suppliers, journal entries, chart of accounts, fiscal years, items, tags, uploads, SIE export, and bank payments.40MIT