bokio-mcp
Ask Claude about your Bokio books: ledger, invoices, VAT and profit and loss
- Pricing
- Open source
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 0.6.0
- Listing updated
- today
Similar MCP servers
About bokio-mcp
bokio-mcp is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
Swedish small companies and consultants who keep their books in Bokio can query them in plain language with this server. It reads by default, so pointing it at live accounting data is safe. Write tools stay hidden until BOKIO_ALLOW_WRITES is switched on, and bank payments are deliberately read-only because creating one would move money once signed with BankID.
Besides wrapping the Bokio API for one company, it computes figures from the SIE export: balances at a date, an account ledger, VAT and profit and loss for a period, open items, possible double bookings and reconciliation against bank statement rows. The README says the arithmetic is done in whole ore so the same question gives the same answer each time. VAT output is account totals, not mapped to VAT-return boxes.
You need a Bokio private integration token, a company id and Node.js 22 or later. Bokio allows 5,000 requests per company per month and 200 per minute, and each computed call downloads one SIE export per fiscal year it needs.
Install
Run in a terminal
claude mcp add bokio-mcp --env BOKIO_TOKEN='<BOKIO_TOKEN>' -- npx -y bokio-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"bokio-mcp": {
"command": "npx",
"args": [
"-y",
"bokio-mcp"
],
"env": {
"BOKIO_TOKEN": "<BOKIO_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"bokio-mcp": {
"command": "npx",
"args": [
"-y",
"bokio-mcp"
],
"env": {
"BOKIO_TOKEN": "<BOKIO_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"bokio-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"bokio-mcp"
],
"env": {
"BOKIO_TOKEN": "<BOKIO_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"bokio-mcp": {
"command": "npx",
"args": [
"-y",
"bokio-mcp"
],
"env": {
"BOKIO_TOKEN": "<BOKIO_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"bokio-mcp": {
"command": "npx",
"args": [
"-y",
"bokio-mcp"
],
"env": {
"BOKIO_TOKEN": "<BOKIO_TOKEN>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
BOKIO_TOKENPrivate Bearer token, created in Bokio under IntegrationsRequiredBOKIO_COMPANY_IDDefault company, used when a tool call leaves out companyIdBOKIO_ALLOW_WRITES1, true, yes or on enables write tools; anything else keeps them hidden and blockedBOKIO_DOWNLOAD_DIRWhere SIE, PDF and upload downloads are saved; paths outside it are rejected and files are never overwrittenBOKIO_BASE_URLDefaults to https://api.bokio.se/v1
Tools this server provides (27)
Taken from the project documentation; the running server may differ.
- bokio_company_info
- Company information.
- bokio_list_fiscal_years
- Lists fiscal years.
- bokio_chart_of_accounts
- Reads the chart of accounts.
- bokio_download_sie
- Downloads the SIE export.
- bokio_list_journal_entries
- Lists journal entries with from, to and query filters.
- bokio_create_journal_entry
- Creates a journal entry (write).
- bokio_reverse_journal_entry
- Reverses a journal entry (write).
- bokio_list_invoices
- Lists invoices.
- bokio_create_invoice
- Creates an invoice (write).
- bokio_publish_invoice
- Publishes an invoice (write).
- bokio_download_invoice
- Downloads an invoice as PDF.
- bokio_list_credit_notes
- Lists credit notes.
- bokio_create_credit_note
- Creates a credit note from an invoice (write).
- bokio_list_suppliers
- Lists suppliers.
- bokio_list_supplier_invoices
- Lists supplier invoices.
- bokio_list_customers
- Lists customers.
- bokio_list_items
- Lists items.
- bokio_upload_file
- Uploads a file (write).
- bokio_list_bank_payments
- Lists bank payments created by the same integration.
- bokio_account_balances
- Computes account balances at a date from the SIE export.
- bokio_account_ledger
- Computes the ledger for one account.
- bokio_find_duplicates
- Finds possible double bookings.
- bokio_reconcile_bank
- Reconciles bank statement rows against the books.
- bokio_vat_summary
- Summarises VAT account totals for a period.
- bokio_profit_and_loss
- Computes profit and loss for a period.
- bokio_open_items
- Lists open items.
- bokio_raw_get
- Sends a GET to any Bokio path.
What it does
- Read-only by default
- Write tools stay hidden and blocked until BOKIO_ALLOW_WRITES is enabled.
- Invoices and credit notes
- List, read, download as PDF, and with writes on create, publish and settle.
- SIE-based reports
- Balances, account ledger, VAT summary and profit and loss for a chosen period.
- Double-booking finder
- Flags possible duplicate bookings in the ledger.
- Bank reconciliation
- Matches your statement rows of date, amount and text against the books.
- Sandboxed downloads
- SIE, PDF and upload downloads go to one directory and never overwrite files.
- Raw GET escape hatch
- bokio_raw_get reaches any Bokio path that has no dedicated tool yet.
Good for
- Ask what the bank account held on a given date
- List customer invoices that are still unpaid
- Sum VAT for last quarter
- Check whether anything has been booked twice
- Reconcile a bank statement against the ledger
- Draft and publish an invoice with writes enabled
Pricing
Open source
MIT licence; a Bokio account is needed
bokio-mcp FAQ
What do I need to run it?
A Bokio private integration token created under Integrations, your company id, and Node.js 22 or later.
Can it change my books?
Only if you set BOKIO_ALLOW_WRITES to 1, true, yes or on. Otherwise write tools are hidden and blocked.
Can it create bank payments?
No. Bank payments are read-only on purpose.
Are there API limits?
The README says Bokio allows 5,000 requests per company per month and 200 per minute.
What is not covered?
Tag groups, projects, journal-entry comments and tags, and invoice attachments have no tools yet but can be read with bokio_raw_get.
Is bokio-mcp free?
Yes. bokio-mcp is open source, so you can use and self-host it for free.
How do I add bokio-mcp to Claude Code?
Run this command in your terminal: claude mcp add bokio-mcp --env BOKIO_TOKEN='<BOKIO_TOKEN>' -- npx -y bokio-mcp
What are the best alternatives to bokio-mcp?
The closest alternatives to bokio-mcp are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Crypto Feeds and Crypto Fng.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

