Skip to main content
Glama
bokio-mcp

bokio-mcp

bokio-mcp

CI npm downloads

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:

  1. 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.

  2. Your company id. It is in the Bokio URL: .../companies/<companyId>/....

  3. 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-mcp

Claude 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

BOKIO_TOKEN

yes, when a tool is called

Private Bearer token

BOKIO_COMPANY_ID

default company

Used when a tool call leaves out companyId

BOKIO_ALLOW_WRITES

no

1, true, yes or on enables write tools; anything else keeps them hidden and blocked

BOKIO_DOWNLOAD_DIR

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 /, as it often is for Claude Desktop. Paths outside the directory are rejected and existing files are never overwritten

BOKIO_BASE_URL

no

Defaults to https://api.bokio.se/v1

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

MIT

Available Tools

37 tools
bokio_account_balancesA
Read-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_ledgerA
Read-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_accountsA
Read-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_infoA
Read-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_noteA
Read-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_invoiceA
Read-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_sieA
Read-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_uploadA
Read-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_duplicatesA
Read-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_accountA
Read-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_paymentA
Read-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_noteA
Read-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_customerB
Read-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_yearA
Read-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_invoiceA
Read-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_itemA
Read-only

Get one item (artikel) by id, as Bokio returns it.

Inputs: itemId (required), companyId.

bokio_get_journal_entryA
Read-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_supplierA
Read-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_invoiceA
Read-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_uploadA
Read-only

Get one upload's metadata by id. bokio_download_upload fetches the file itself.

Inputs: uploadId (required), companyId.

bokio_list_bank_paymentsA
Read-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_notesA
Read-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_customersA
Read-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_yearsA
Read-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_paymentsA
Read-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_invoicesA
Read-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_settlementsA
Read-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_itemsA
Read-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_entriesA
Read-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_invoicesA
Read-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_suppliersA
Read-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_uploadsA
Read-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_itemsA
Read-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_lossA
Read-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_getA
Read-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_bankA
Read-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_summaryA
Read-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

    A3.7/5.0

    Scored across 37 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness3/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to read and write Cynco accounting data, including querying books, creating invoices, reconciling transactions, and generating financial reports.
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with the sevDesk accounting API for managing contacts, invoices, credit notes, orders, vouchers, transactions, and parts.
      24 npm
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Connects 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.
      40
      44 npm
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      40
      MIT