fiken-mcp
Click on "Install 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., "@fiken-mcplist my unpaid invoices"
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.
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 —
companySlugis a parameter on every toolPaginated 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
Related MCP server: FreeAgent MCP Server
Requirements
Node.js 18+
Installation
git clone https://github.com/yourusername/fiken-mcp
cd fiken-mcp
npm install
npm run buildUsage
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.jsonWindows:
%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.jsThen set the token:
claude mcp add fiken -e FIKEN_API_TOKEN=your-token-here -- node /absolute/path/to/fiken-mcp/build/index.jsOr 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 listOther MCP clients
Run the server with the token in the environment:
FIKEN_API_TOKEN=your-token-here node build/index.jsDevelopment (no build step)
FIKEN_API_TOKEN=your-token-here npm run devMCP Inspector
FIKEN_API_TOKEN=your-token-here npx @modelcontextprotocol/inspector node build/index.jsGetting a Fiken API token
Log in to fiken.no
Go to Settings → API (or visit
https://fiken.no/api/v2/documentation)Generate a personal API token
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 |
| Get information about the currently authenticated Fiken user |
Companies
Tool | Description |
| List all companies the authenticated user has access to |
| Get details for a specific company by slug |
Accounts
Tool | Description |
| List chart of accounts for a company |
| Get a specific account by account code |
| List account balances for a company |
| Get balance for a specific account |
Bank
Tool | Description |
| List bank accounts for a company |
| Get a specific bank account by ID |
| List bank balances for all bank accounts |
Contacts
Tool | Description |
| List contacts (customers and suppliers) |
| Get a specific contact by ID |
| List contact persons for a contact |
| Get a specific contact person |
| List contact groups |
Invoices
Tool | Description |
| List invoices |
| Get a specific invoice by ID |
| List attachments for an invoice |
| Get the current invoice number counter |
| List invoice drafts |
| Get a specific invoice draft |
| List attachments for an invoice draft |
Credit Notes
Tool | Description |
| List credit notes |
| Get a specific credit note |
| Get the current credit note number counter |
| List credit note drafts |
| Get a specific credit note draft |
Offers
Tool | Description |
| List offers/quotes |
| Get a specific offer |
| Get the current offer number counter |
| List offer drafts |
| Get a specific offer draft |
Order Confirmations
Tool | Description |
| List order confirmations |
| Get a specific order confirmation |
| Get the current order confirmation counter |
Journal Entries
Tool | Description |
| List journal entries |
| Get a specific journal entry |
| List attachments for a journal entry |
Transactions
Tool | Description |
| List transactions |
| Get a specific transaction |
Sales
Tool | Description |
| List sales |
| Get a specific sale |
| List attachments for a sale |
| List sale drafts |
| Get a specific sale draft |
| List attachments for a sale draft |
Purchases
Tool | Description |
| List purchases |
| Get a specific purchase |
| List attachments for a purchase |
| List purchase drafts |
| Get a specific purchase draft |
Products
Tool | Description |
| List products |
| Get a specific product |
Projects
Tool | Description |
| List projects |
| Get a specific project |
Time Tracking
Tool | Description |
| List time entries |
| Get a specific time entry |
| List activities (used with time entries) |
| List users who can log time |
Inbox
Tool | Description |
| List inbox documents |
| Get a specific inbox document |
Notes
Amounts are returned in øre (cents) as integers, matching the Fiken API — e.g.
100000means 1000.00 NOKAccount 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-DDformat
Development
npm test # run tests
npm run build # compile TypeScript
npm run dev # run without building (uses tsx)License
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/heim/fiken-read-only-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server