Fiken MCP

Open-source TypeScript client, Model Context Protocol server and CLI for Fiken. Unofficial; not affiliated with Fiken AS.

Companies, accounts, contacts, purchases and purchase attachments.

Package and release status

@bruchris/fiken-mcp version 0.1.0 is prepared but not yet published to npm. Requires Node 22.14+; Node 24 is recommended. The following installation command applies after the first npm release.

npx -y @bruchris/fiken-mcp

Set FIKEN_API_TOKEN in your client environment. Import the typed client from @bruchris/fiken-mcp/client without launching MCP or loading environment files. Fiken restricts personal-key use in third-party applications; obtain required OAuth/vendor authorization before offering an integration to other firms. See Fiken API documentation.

Related MCP server: MCP YNAB Server

Approval

MCP writes return a preview until confirm=true; the client must obtain approval before confirming. CLI writes require --confirm. For paid purchases, take the payment date and NOK amount from the booked bank transaction. Attach a receipt to the purchase; do not duplicate it into Fiken Innboks. The model chooses accounting fields after reading the receipt and similar bookings.

Development

npm ci
npm test
npm run typecheck
npm run build
npm run test:tooling
npm run check:public
npm run check:secrets

This repository contains only the Fiken package in packages/fiken-mcp and its supporting tooling. Its root workspace is private to prevent accidental publication of the tooling. The Freddy application source remains private and is excluded.

Package documentation · Public docs · Hosting · Contributing · Releases · Security

MIT license.