fiken-mcp

A read-only Model Context Protocol (MCP) server for the Fiken accounting API. Exposes all Fiken GET endpoints as MCP tools so AI assistants (Claude, etc.) can query your accounting data directly.

Read-only guarantee: This server only ever makes HTTP GET requests to the Fiken API. No data is created, modified, or deleted.

Features

• 61 tools covering the full Fiken v2 read API
• Multi-company support — companySlug is a parameter on every tool
• Paginated list endpoints with metadata
• Serial request queue (respects Fiken's 1 concurrent request per user rule)
• Structured error responses — API errors are returned as tool results rather than crashing the session

Requirements

• Node.js 18+
• A Fiken API token

Installation

git clone https://github.com/yourusername/fiken-mcp
cd fiken-mcp
npm install
npm run build

Usage

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "fiken": {
      "command": "node",
      "args": ["/absolute/path/to/fiken-mcp/build/index.js"],
      "env": {
        "FIKEN_API_TOKEN": "your-token-here"
      }
    }
  }
}

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Code

Add the server to your Claude Code project with:

claude mcp add fiken -- node /absolute/path/to/fiken-mcp/build/index.js

Then set the token:

claude mcp add fiken -e FIKEN_API_TOKEN=your-token-here -- node /absolute/path/to/fiken-mcp/build/index.js

Or if you prefer to keep the config in version control, add it to .mcp.json in your project root:

{
  "mcpServers": {
    "fiken": {
      "command": "node",
      "args": ["/absolute/path/to/fiken-mcp/build/index.js"],
      "env": {
        "FIKEN_API_TOKEN": "your-token-here"
      }
    }
  }
}

To verify the server is connected:

claude mcp list

Other MCP clients

Run the server with the token in the environment:

FIKEN_API_TOKEN=your-token-here node build/index.js

Development (no build step)

FIKEN_API_TOKEN=your-token-here npm run dev

MCP Inspector

FIKEN_API_TOKEN=your-token-here npx @modelcontextprotocol/inspector node build/index.js

Getting a Fiken API token

1. Log in to fiken.no
2. Go to Settings → API (or visit https://fiken.no/api/v2/documentation)
3. Generate a personal API token
4. Keep it secret — treat it like a password

Available tools

Start with fiken_list_companies to get the companySlug values needed by all other tools.

User

Tool	Description
fiken_get_user	Get information about the currently authenticated Fiken user

Companies

Tool	Description
fiken_list_companies	List all companies the authenticated user has access to
fiken_get_company	Get details for a specific company by slug

Accounts

Tool	Description
fiken_list_accounts	List chart of accounts for a company
fiken_get_account	Get a specific account by account code
fiken_list_account_balances	List account balances for a company
fiken_get_account_balance	Get balance for a specific account

Bank

Tool	Description
fiken_list_bank_accounts	List bank accounts for a company
fiken_get_bank_account	Get a specific bank account by ID
fiken_list_bank_balances	List bank balances for all bank accounts

Contacts

Tool	Description
fiken_list_contacts	List contacts (customers and suppliers)
fiken_get_contact	Get a specific contact by ID
fiken_list_contact_persons	List contact persons for a contact
fiken_get_contact_person	Get a specific contact person
fiken_list_contact_groups	List contact groups

Invoices

Tool	Description
fiken_list_invoices	List invoices
fiken_get_invoice	Get a specific invoice by ID
fiken_list_invoice_attachments	List attachments for an invoice
fiken_get_invoice_counter	Get the current invoice number counter
fiken_list_invoice_drafts	List invoice drafts
fiken_get_invoice_draft	Get a specific invoice draft
fiken_list_invoice_draft_attachments	List attachments for an invoice draft

Credit Notes

Tool	Description
fiken_list_credit_notes	List credit notes
fiken_get_credit_note	Get a specific credit note
fiken_get_credit_note_counter	Get the current credit note number counter
fiken_list_credit_note_drafts	List credit note drafts
fiken_get_credit_note_draft	Get a specific credit note draft

Offers

Tool	Description
fiken_list_offers	List offers/quotes
fiken_get_offer	Get a specific offer
fiken_get_offer_counter	Get the current offer number counter
fiken_list_offer_drafts	List offer drafts
fiken_get_offer_draft	Get a specific offer draft

Order Confirmations

Tool	Description
fiken_list_order_confirmations	List order confirmations
fiken_get_order_confirmation	Get a specific order confirmation
fiken_get_order_confirmation_counter	Get the current order confirmation counter

Journal Entries

Tool	Description
fiken_list_journal_entries	List journal entries
fiken_get_journal_entry	Get a specific journal entry
fiken_list_journal_entry_attachments	List attachments for a journal entry

Transactions

Tool	Description
fiken_list_transactions	List transactions
fiken_get_transaction	Get a specific transaction

Sales

Tool	Description
fiken_list_sales	List sales
fiken_get_sale	Get a specific sale
fiken_list_sale_attachments	List attachments for a sale
fiken_list_sale_drafts	List sale drafts
fiken_get_sale_draft	Get a specific sale draft
fiken_list_sale_draft_attachments	List attachments for a sale draft

Purchases

Tool	Description
fiken_list_purchases	List purchases
fiken_get_purchase	Get a specific purchase
fiken_list_purchase_attachments	List attachments for a purchase
fiken_list_purchase_drafts	List purchase drafts
fiken_get_purchase_draft	Get a specific purchase draft

Products

Tool	Description
fiken_list_products	List products
fiken_get_product	Get a specific product

Projects

Tool	Description
fiken_list_projects	List projects
fiken_get_project	Get a specific project

Time Tracking

Tool	Description
fiken_list_time_entries	List time entries
fiken_get_time_entry	Get a specific time entry
fiken_list_activities	List activities (used with time entries)
fiken_list_time_users	List users who can log time

Inbox

Tool	Description
fiken_list_inbox	List inbox documents
fiken_get_inbox_document	Get a specific inbox document

Notes

• Amounts are returned in øre (cents) as integers, matching the Fiken API — e.g. 100000 means 1000.00 NOK
• Account codes are strings — e.g. "1920" or "1500:10001"
• Pagination defaults to page 0, 25 results per page (max 100)
• Date filters use YYYY-MM-DD format

Development

npm test          # run tests
npm run build     # compile TypeScript
npm run dev       # run without building (uses tsx)

License

MIT