gronnmann/fiken-mcp

7 stars 5 forks Quality 74 Trend 29

A Model Context Protocol (MCP) to interact with the Norwegian accounting software Fiken's API

Overview

A Model Context Protocol (MCP) server that connects AI assistants like and to the Fiken accounting API. Manage invoices, contacts, purchases, journal entries, and more — directly from your AI assistant. All mutating operations (POST, PUT, PATCH, DELETE) require explicit user approval before executing. : This is an unofficial library and is not affiliated with or endorsed by Fiken AS. Use at own risk. : Built using Claude Code. Use at own risk. - : Create, send, and manage invoices and credit notes with full draft support - : Full CRUD for customers and suppliers, including contact persons - : Record and manage purchases and sales transactions - : List, register, and delete payments on existing sales and purchases; pay an invoice via fiken_create_invoice_payment - : Create and send offers, convert to invoices - : Bookkeeping accounts, bank accounts, journal entries, transactions - : Product sales reports, account balances - : Projects, time entries, activities, team members Add...

README

fiken-mcp: Model Context Protocol Server for Fiken Accounting API

A Model Context Protocol (MCP) server that connects AI assistants like Claude and Cursor to the Fiken accounting API. Manage invoices, contacts, purchases, journal entries, and more — directly from your AI assistant.

All mutating operations (POST, PUT, PATCH, DELETE) require explicit user approval before executing.

NOTE: This is an unofficial library and is not affiliated with or endorsed by Fiken AS. Use at own risk.

NOTE: Built using Claude Code. Use at own risk.

Features

Invoices & Credit Notes: Create, send, and manage invoices and credit notes with full draft support
Contacts: Full CRUD for customers and suppliers, including contact persons
Purchases & Sales: Record and manage purchases and sales transactions
Payments: List, register, and delete payments on existing sales and purchases; pay an invoice via fiken_create_invoice_payment
Offers & Order Confirmations: Create and send offers, convert to invoices
Accounting: Bookkeeping accounts, bank accounts, journal entries, transactions
Reports: Product sales reports, account balances
Time Tracking: Projects, time entries, activities, team members

Configuration

Add the server to your AI client config. No installation needed — npx/pnpx will fetch it automatically.

Getting Your Credentials

API Token: fiken.no → Profile → API → Personal tokens
Company Slug: Found in your Fiken URL: fiken.no/company/YOUR-SLUG/...

Claude Desktop

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

{
    "mcpServers": {
        "fiken": {
            "command": "npx",
            "args": ["-y", "fiken-mcp"],
            "env": {
                "FIKEN_API_TOKEN": "your-personal-token-here",
                "FIKEN_COMPANY_SLUG": "your-company-slug"
            }
        }
    }
}

Or with pnpm:

{
    "mcpServers": {
        "fiken": {
            "command": "pnpx",
            "args": ["fiken-mcp"],
            "env": {
                "FIKEN_API_TOKEN": "your-personal-token-here",
                "FIKEN_COMPANY_SLUG": "your-company-slug"
            }
        }
    }
}

Claude Code

Add to ~/.claude.json under mcpServers:

{
    "mcpServers": {
        "fiken": {
            "command": "npx",
            "args": ["-y", "fiken-mcp"],
            "env": {
                "FIKEN_API_TOKEN": "your-personal-token-here",
                "FIKEN_COMPANY_SLUG": "your-company-slug"
            }
        }
    }
}

Cursor

Add to ~/.cursor/mcp.json:

{
    "mcpServers": {
        "fiken": {
            "command": "npx",
            "args": ["-y", "fiken-mcp"],
            "env": {
                "FIKEN_API_TOKEN": "your-personal-token-here",
                "FIKEN_COMPANY_SLUG": "your-company-slug"
            }
        }
    }
}

Available Tools

Category	Tools
User	`fiken_get_user`
Companies	`fiken_list_companies`, `fiken_get_company`
Accounts	`fiken_list_accounts`, `fiken_get_account`, `fiken_list_account_balances`, `fiken_get_account_balance`
Bank	`fiken_list_bank_accounts`, `fiken_create_bank_account`, `fiken_get_bank_account`, `fiken_list_bank_balances`
Contacts	`fiken_list_contacts`, `fiken_create_contact`, `fiken_get_contact`, `fiken_update_contact`, `fiken_delete_contact`, `fiken_list_contact_persons`, `fiken_create_contact_person`, `fiken_get_contact_person`, `fiken_update_contact_person`, `fiken_delete_contact_person`, `fiken_list_groups`
Invoices	`fiken_list_invoices`, `fiken_create_invoice`, `fiken_get_invoice`, `fiken_update_invoice`, `fiken_get_invoice_attachments`, `fiken_send_invoice`, `fiken_get_invoice_counter`, `fiken_create_invoice_counter`, `fiken_list_invoice_drafts`, `fiken_create_invoice_draft`, `fiken_get_invoice_draft`, `fiken_update_invoice_draft`, `fiken_delete_invoice_draft`, `fiken_get_invoice_draft_attachments`, `fiken_create_invoice_from_draft`
Credit Notes	`fiken_list_credit_notes`, `fiken_get_credit_note`, `fiken_create_full_credit_note`, `fiken_create_partial_credit_note`, `fiken_send_credit_note`, `fiken_get_credit_note_counter`, `fiken_create_credit_note_counter`, `fiken_list_credit_note_drafts`, `fiken_create_credit_note_draft`, `fiken_get_credit_note_draft`, `fiken_update_credit_note_draft`, `fiken_delete_credit_note_draft`, `fiken_get_credit_note_draft_attachments`, `fiken_create_credit_note_from_draft`
Offers	`fiken_list_offers`, `fiken_get_offer`, `fiken_get_offer_counter`, `fiken_create_offer_counter`, `fiken_list_offer_drafts`, `fiken_create_offer_draft`, `fiken_get_offer_draft`, `fiken_update_offer_draft`, `fiken_delete_offer_draft`, `fiken_get_offer_draft_attachments`, `fiken_create_offer_from_draft`, `fiken_send_offer`
Order Confirmations	`fiken_list_order_confirmations`, `fiken_get_order_confirmation`, `fiken_get_order_confirmation_counter`, `fiken_create_order_confirmation_counter`, `fiken_create_invoice_draft_from_order_confirmation`
Purchases	`fiken_list_purchases`, `fiken_create_purchase`, `fiken_get_purchase`, `fiken_delete_purchase`, `fiken_get_purchase_attachments`, `fiken_add_purchase_attachment`, `fiken_list_purchase_drafts`, `fiken_create_purchase_draft`, `fiken_get_purchase_draft`, `fiken_update_purchase_draft`, `fiken_delete_purchase_draft`, `fiken_get_purchase_draft_attachments`, `fiken_create_purchase_from_draft`
Sales	`fiken_list_sales`, `fiken_create_sale`, `fiken_get_sale`, `fiken_delete_sale`, `fiken_get_sale_attachments`, `fiken_list_sale_drafts`, `fiken_create_sale_draft`, `fiken_get_sale_draft`, `fiken_update_sale_draft`, `fiken_delete_sale_draft`, `fiken_get_sale_draft_attachments`, `fiken_create_sale_from_draft`
Journal Entries	`fiken_list_journal_entries`, `fiken_get_journal_entry`, `fiken_get_journal_entry_attachments`, `fiken_create_journal_entry`
Transactions	`fiken_list_transactions`, `fiken_get_transaction`, `fiken_delete_transaction`
Misc	`fiken_create_product_sales_report`, `fiken_list_projects`, `fiken_list_time_entries`, `fiken_list_activities`, `fiken_list_time_users`, `fiken_list_inbox`

Note: Amounts are in NOK øre (1/100 of a krone). Dates use YYYY-MM-DD format.

Local Development

git clone https://github.com/gronnmann/fiken-mcp.git
cd fiken-mcp
pnpm install       # Install dependencies
pnpm build         # Compile TypeScript → build/
pnpm dev           # Run with tsx (no build needed)

License

MIT

View the full README on GitHub

Install

npx -y fiken-mcp

New to MCP? Start with the mcpskill.org guide →

Configuration

{
    "mcpServers": {
        "fiken": {
            "command": "npx",
            "args": ["-y", "fiken-mcp"],
            "env": {
                "FIKEN_API_TOKEN": "your-personal-token-here",
                "FIKEN_COMPANY_SLUG": "your-company-slug"
            }
        }
    }
}