folio-mcp

Talk to your Folio business bank account from Claude.

An MCP server for the official Folio API — accounts, transactions, receipts, bookkeeping and payments as tools for Claude and any other MCP client.

"Which card purchases from May are still missing receipts?" · "Upload this receipt to the Clas Ohlson purchase" · "What did we spend on advertising this quarter?" · "Draft the June rent payment"

Unofficial community project — not affiliated with Folio. Payments created through the API are always drafts that must be approved in the Folio app before any money moves.

Install

You need a Folio API key — create one at app.folio.no/til/api-tilgang.

Claude Desktop — download the latest folio-mcp.mcpb from Releases, double-click it, paste your API key. The key is stored in your OS keychain; nothing is sent anywhere except directly to Folio.

Claude Code

claude mcp add folio --env FOLIO_API_KEY=your-key -- npx -y @henrikkvamme/folio-mcp

Any MCP client — stdio command npx -y @henrikkvamme/folio-mcp (or bunx) with FOLIO_API_KEY in the environment.

Related MCP server: Solvent MCP Server

Tools

Receipts download as inline images. Ledger categories map to Norsk Standardkontoplan (NS4102) with VAT codes.

Try it without a Folio account

No public sandbox exists, so the repo ships a stateful mock of the API with realistic data:

bun install && bun run mock                # mock API on :8787
FOLIO_API_KEY=test FOLIO_API_URL=http://localhost:8787 bun run inspect

Remote server (optional)

A Streamable HTTP entry point (Hono, stateless, bearer-auth) for VPS deployment:

MCP_AUTH_TOKEN=$(openssl rand -hex 32) FOLIO_API_KEY=your-key bun run src/http.ts
claude mcp add --transport http folio https://your-host/mcp --header "Authorization: Bearer $MCP_AUTH_TOKEN"

⚠️ The API key reads your full account history and can create payment drafts. Prefer local stdio; never expose the HTTP entry without auth.

Development

Bun + TypeScript, @modelcontextprotocol/sdk, zod v4, oxlint/oxfmt, tsdown.

bun install
bun run typecheck && bun run lint   # checks
bun run inspect                     # MCP Inspector
bun run build                       # npm dist (Node ≥ 18)
bun run mcpb                        # Claude Desktop bundle

src/server.ts holds all tool definitions in a createServer() factory shared by both transports (src/stdio.ts, src/http.ts).

License

MIT