bokio-mcp
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 Which invoices are still unpaid?"
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. It exposes 85 tools over one Bokio company — invoices, customers, suppliers, supplier invoices, journal entries, credit notes, the chart of accounts, fiscal years, items, tags, uploads, SIE export and bank payments — so an MCP client can read and (optionally) write your bookkeeping.
No accounts, no database, no hosted service. One company per server instance.
"Which invoices are still unpaid?"
"Book the attached receipt against account 6570."
"Export the SIE file for the 2025 fiscal year."Quick start
Try it with fixtures, no Bokio account needed:
BOKIO_MOCK=true npx bokio-mcp status
# { "companyName": "Testbolaget AB", "status": "active", ... }BOKIO_MOCK=true serves an in-process fake Bokio, so the full tool surface works
before you have any credentials.
For real data, pick one of the two credential routes below and add the server to your MCP client.
Route A — private integration token (recommended)
In Bokio: company settings → Integrations → API tokens → Create private integration. The token is long-lived, scoped to that one company, and needs no OAuth review.
{
"mcpServers": {
"bokio": {
"command": "npx",
"args": ["-y", "bokio-mcp"],
"env": {
"BOKIO_INTEGRATION_TOKEN": "your-token",
"BOKIO_COMPANY_ID": "the-company-uuid-from-the-bokio-url"
}
}
}
}Route B — OAuth
Register an integration in Bokio's developer portal with the redirect URI
http://127.0.0.1:7337/callback, then:
export BOKIO_CLIENT_ID=... BOKIO_CLIENT_SECRET=...
npx bokio-mcp loginThat opens Bokio in your browser and writes the tokens to
~/.config/bokio-mcp/tokens.json (mode 0600). Access tokens are refreshed
automatically, including refresh-token rotation. Point your MCP client at
npx -y bokio-mcp with the same two env vars set.
Related MCP server: e-conomic MCP Server
Writes are off by default
A fresh install can read but not write. Mutating tools are not merely blocked — they are
absent from tools/list, so the model never proposes an edit it cannot make:
BOKIO_ALLOW_WRITES=trueOf the 85 tools, 38 are read-only and 47 mutate. Start without the flag, confirm the model is reading what you expect, then turn writes on.
Commands
| Serve over stdio — what MCP clients launch |
| Serve over streamable HTTP on |
| Connect a company via OAuth |
| Print the current connection and exit |
HTTP transport
For self-hosting, e.g. behind a reverse proxy or in a container:
MCP_AUTH_TOKEN=$(openssl rand -hex 32) bokio-mcp serve --http/mcp is then guarded by that static bearer. Without MCP_AUTH_TOKEN the server
binds 127.0.0.1 only rather than exposing an unauthenticated bridge to live
accounting data. A Dockerfile is included; it defaults to this transport.
Environment
Variable | Default | |
| — | Route A: private integration token |
| — | Route A: the company's UUID |
| — | Route B: OAuth credentials |
|
| Register mutating tools |
|
| Serve in-process fixtures instead of Bokio |
| see | OAuth scopes requested by |
|
| Where OAuth tokens live |
| — | Optional AES-256-GCM at rest; |
|
| Cap on inline uploads/downloads |
|
| HTTP transport |
| — | Bearer guarding |
|
| Loopback port used by |
See .env.example for the annotated version.
A note on token storage
The OAuth token file is plaintext at mode 0600 unless BOKIO_TOKEN_ENCRYPTION_KEY is
set — the same posture as the gh and aws CLIs. On a personal machine a key stored
next to the thing it encrypts adds little; set it when the file lives somewhere less
private, such as a container image or a shared host.
Development
npm install
npm test # 36 tests, no database, no credentials
npm run typecheck
npm run dev # tsx watch, stdio transportBOKIO_MOCK=true routes every Bokio request into an in-process mock at the fetch
layer, so it behaves identically under stdio, under HTTP, and inside tests with no
server running. test/mcp.test.ts drives the real MCP protocol end to end against it.
Tool definitions are hand-written in src/tools/bokio/, but each one's path and method
are checked against the OpenAPI spec at compile time by the op() helper — a typo in a
route fails the build. Regenerate the spec types with:
npm run gen:bokioNot supported
More than one company per instance. Bokio credentials are per-company; run a second instance for a second company.
Elevated scopes.
bank-payments:*requires per-integration approval from Bokio. The bank payment tools are registered but will fail until your integration is approved and the scopes are added toBOKIO_SCOPES.
License
MIT
Available Tools
40 toolsbokio_download_credit_noteDownload credit note PDFARead-onlyIdempotent
Downloads the credit note as a PDF file.
Inputs: creditNoteId (required).
bokio_download_invoiceDownload invoice PDFARead-onlyIdempotent
Downloads the invoice as a PDF file.
Inputs: invoiceId (required).
bokio_download_invoice_attachmentDownload invoice attachmentARead-onlyIdempotent
Downloads an invoice attachment file.
Inputs: invoiceId (required), attachmentId (required).
bokio_download_sieDownload SIE fileARead-onlyIdempotent
Downloads the SIE export (Swedish standard accounting interchange format) for a fiscal year.
Inputs: fiscalYearId (required).
bokio_download_uploadDownload uploadBRead-onlyIdempotent
Downloads an uploaded file.
Inputs: uploadId (required).
bokio_get_accountGet accountARead-onlyIdempotent
Fetches one account by its number (e.g. 1930).
Inputs: account (required).
bokio_get_bank_paymentGet bank paymentARead-onlyIdempotent
Fetches one bank payment created by this integration.
Inputs: bankPaymentId (required).
bokio_get_company_informationGet company informationARead-onlyIdempotent
Fetches the company's registered information (name, org number, type, address).
Inputs: no named parameters.
bokio_get_credit_noteGet credit noteCRead-onlyIdempotent
Fetches one credit note.
Inputs: creditNoteId (required).
bokio_get_customerGet customerBRead-onlyIdempotent
Fetches one customer.
Inputs: customerId (required).
bokio_get_fiscal_yearGet fiscal yearCRead-onlyIdempotent
Fetches one fiscal year.
Inputs: fiscalYearId (required).
bokio_get_invoiceGet invoiceARead-onlyIdempotent
Fetches one invoice including line items, payments and status.
Inputs: invoiceId (required).
bokio_get_invoice_attachmentGet invoice attachmentBRead-onlyIdempotent
Fetches attachment metadata.
Inputs: invoiceId (required), attachmentId (required).
bokio_get_invoice_paymentGet invoice paymentARead-onlyIdempotent
Fetches one payment on an invoice.
Inputs: invoiceId (required), paymentId (required).
bokio_get_invoice_settlementGet invoice settlementBRead-onlyIdempotent
Fetches one settlement on an invoice.
Inputs: invoiceId (required), settlementId (required).
bokio_get_itemGet itemBRead-onlyIdempotent
Fetches one item.
Inputs: itemId (required).
bokio_get_journal_entryGet journal entryBRead-onlyIdempotent
Fetches one journal entry with its debit/credit items.
Inputs: journalEntryId (required).
bokio_get_journal_entry_commentGet journal entry commentARead-onlyIdempotent
Fetches one comment on a journal entry.
Inputs: commentId (required), journalEntryId (required).
bokio_get_supplierGet supplierARead-onlyIdempotent
Fetches one supplier.
Inputs: supplierId (required).
bokio_get_supplier_invoiceGet supplier invoiceBRead-onlyIdempotent
Fetches one supplier invoice.
Inputs: supplierInvoiceId (required).
bokio_get_tag_groupGet tag groupBRead-onlyIdempotent
Fetches one tag group.
Inputs: tagGroupId (required).
bokio_get_uploadGet uploadARead-onlyIdempotent
Fetches metadata for one uploaded file.
Inputs: uploadId (required).
bokio_list_accountsList chart of accountsARead-onlyIdempotent
Lists the chart of accounts (kontoplan), optionally filtered by free text.
Inputs: query.
bokio_list_bank_paymentsList bank paymentsBRead-onlyIdempotent
Lists bank payments created by this integration (limited read).
Inputs: page, query, pageSize.
bokio_list_credit_notesList credit notesARead-onlyIdempotent
Lists credit notes with paging and free-text filtering.
Inputs: page, query, pageSize.
bokio_list_customersList customersARead-onlyIdempotent
Lists customers with paging and free-text filtering.
Inputs: page, query, pageSize.
bokio_list_fiscal_yearsList fiscal yearsARead-onlyIdempotent
Lists the company's fiscal years.
Inputs: page, query, pageSize.
bokio_list_invoice_attachmentsList invoice attachmentsBRead-onlyIdempotent
Lists file attachments on an invoice.
Inputs: invoiceId (required), page, query, pageSize.
bokio_list_invoice_paymentsList invoice paymentsARead-onlyIdempotent
Lists payments registered on an invoice.
Inputs: invoiceId (required), page, query, pageSize.
bokio_list_invoicesList invoicesARead-onlyIdempotent
Lists customer invoices with paging and free-text filtering.
Inputs: page, query, pageSize.
bokio_list_invoice_settlementsList invoice settlementsBRead-onlyIdempotent
Lists settlements on an invoice.
Inputs: invoiceId (required), page, query, pageSize.
bokio_list_itemsList itemsARead-onlyIdempotent
Lists inventory/product items with paging and free-text filtering.
Inputs: page, query, pageSize.
bokio_list_journal_entriesList journal entriesARead-onlyIdempotent
Lists journal entries (verifikationer) with paging, free-text filter and optional tagId.
Inputs: page, query, tagId, pageSize.
bokio_list_journal_entry_commentsList journal entry commentsBRead-onlyIdempotent
Lists comments on a journal entry.
Inputs: journalEntryId (required).
bokio_list_supplier_invoicesList supplier invoicesARead-onlyIdempotent
Lists supplier invoices with paging and free-text filtering.
Inputs: page, query, pageSize.
bokio_list_suppliersList suppliersARead-onlyIdempotent
Lists suppliers with paging and free-text filtering.
Inputs: page, query, pageSize.
bokio_list_tag_groupsList tag groupsBRead-onlyIdempotent
Lists tag groups (cost centers, projects, etc.) with their tags.
Inputs: page, query, pageSize.
bokio_list_uploadsList uploadsBRead-onlyIdempotent
Lists uploaded files (receipts, documents) with paging.
Inputs: page, query, pageSize.
get_connection_statusGet connection statusARead-onlyIdempotent
Shows which Bokio company this server is connected to, the health of its access token, and whether write operations are enabled. Call this first if another tool reports an authentication problem.
Inputs: no named parameters.
pingARead-only
Health check: verifies the MCP connection is working.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 40 tools
Each tool targets a distinct entity or action (list vs get vs download) with clear hierarchical relationships (e.g., invoice → payments/settlements/attachments). No overlapping purposes that would cause misselection.
All domain tools follow a strict 'bokio_verb_noun' pattern (list/get/download), with utility tools (ping, get_connection_status) clearly separated. The naming is highly predictable and consistent.
With 40 tools, the count is on the heavier side but justified by the breadth of accounting entities (invoices, customers, journal entries, items, uploads, etc.). Each tool serves a specific resource, though some consolidation could reduce redundancy.
The tool surface comprehensively covers read operations across all major accounting entities, including downloads and SIE export. However, it lacks any create/update/delete tools, so the lifecycle is incomplete unless the server is intentionally read-only.
Maintenance
Related MCP Connectors
Read Bokio accounts, invoices and customers; create drafts and journal entries.
Headless API-first double-entry accounting & bookkeeping engine. 84 MCP tools over HTTP.
Fortnox accounting for one company: invoices, reports, ledger, documents. Read-only until enabled.
Swedish bookkeeping for small businesses: ledger, invoices, VAT, payroll. Same tools as REST API.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables interaction with the Bokio accounting API for managing journal entries, invoices, customers, items, and more, with read-only mode by default for safety.3785 npm3MIT
- FlicenseNot gradedqualityBmaintenanceExposes Visma e-conomic REST API as 73 MCP tools for managing customers, suppliers, products, invoices, quotes, orders, accounting, and reference data, with secure authentication, allowlist, read-only mode, and audit logging.-

epago MCP Serverofficial
AlicenseNot gradedqualityCmaintenanceEnables MCP-capable clients to read and write directly in epago accounting, including chart of accounts, transactions, invoices, payments, receipts, and tax reports.MIT- AlicenseBqualityCmaintenanceEnables MCP clients to read invoices, supplier invoices, vouchers, financial reports, and AR/AP ageing from a Swedish accounting system, with optional draft-only write tools for customers, offers, orders, and unsent invoice drafts after confirmation. It also exposes many other read endpoints through a safety allowlist.261MIT