Skip to content
MCP server

bokio-mcp

Ask Claude about your Bokio books: ledger, invoices, VAT and profit and loss

Runs locallyStatus and history
Install
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-mcp

Add 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 IntegrationsRequired
  • BOKIO_COMPANY_IDDefault company, used when a tool call leaves out companyId
  • BOKIO_ALLOW_WRITES1, true, yes or on enables write tools; anything else keeps them hidden and blocked
  • BOKIO_DOWNLOAD_DIRWhere SIE, PDF and upload downloads are saved; paths outside it are rejected and files are never overwritten
  • BOKIO_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.

How AIPoweredBot checks servers