# bokio-mcp

> bokio-mcp is an open-source MCP server for finance and payments. Ask Claude about your Bokio books: ledger, invoices, VAT and profit and loss. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Repository:** https://github.com/diblaze/bokio-mcp
- **MCP Registry name:** io.github.diblaze/bokio-mcp
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add bokio-mcp --env BOKIO_TOKEN='<BOKIO_TOKEN>' -- npx -y bokio-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "bokio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bokio-mcp"
      ],
      "env": {
        "BOKIO_TOKEN": "<BOKIO_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "bokio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bokio-mcp"
      ],
      "env": {
        "BOKIO_TOKEN": "<BOKIO_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "bokio-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "bokio-mcp"
      ],
      "env": {
        "BOKIO_TOKEN": "<BOKIO_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "bokio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bokio-mcp"
      ],
      "env": {
        "BOKIO_TOKEN": "<BOKIO_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "bokio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bokio-mcp"
      ],
      "env": {
        "BOKIO_TOKEN": "<BOKIO_TOKEN>"
      }
    }
  }
}
```

## Tools

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

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

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Crypto Feeds](https://ai-powered.com/mcp/crypto-feeds): Crypto Feeds is a freemium MCP server for finance and payments.
- [Crypto Fng](https://ai-powered.com/mcp/crypto-fng): Crypto Fng is a freemium MCP server for finance and payments.
- [Creditcard](https://ai-powered.com/mcp/creditcard): Creditcard is a freemium MCP server for finance and payments.
- [Zovo LEI Lookup](https://ai-powered.com/mcp/zovo-lei-lookup): Zovo LEI Lookup is an MCP server for finance and payments.
- [Recurly](https://ai-powered.com/mcp/recurly): Recurly is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/bokio-mcp
