# e-arveldaja-mcp

Connect an AI assistant to Estonia’s e-arveldaja accounting service to handle invoices, bank imports and reports. You’ll need API credentials to get started.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 39
- Author: iseppo
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/iseppo/e-arveldaja-mcp
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/e-arveldaja-mcp

## What it does

This MCP server connects to the REST API for Estonia’s e-arveldaja (RIK e-Financials). An assistant can use it to work with invoices and accounting entries, bring in bank data and retrieve reports. The package also provides guided accounting workflows and reference resources.

Set `EARVELDAJA_API_KEY_ID`, `EARVELDAJA_API_PUBLIC_VALUE` and `EARVELDAJA_API_PASSWORD` for access. Create a token in e-arveldaja settings and add your public IP to its allowed list. This is experimental software that can alter live financial records, so test on the demo server before using it with real accounts.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `EARVELDAJA_API_KEY_ID`, `EARVELDAJA_API_PUBLIC_VALUE`, `EARVELDAJA_API_PASSWORD`, `EARVELDAJA_SERVER`, `EARVELDAJA_ALLOWED_PATHS`, `EARVELDAJA_DISABLE_PROGRESS`, `EARVELDAJA_DEFAULT_CONNECTION`, `EARVELDAJA_LOG_FILE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env EARVELDAJA_API_KEY_ID=<EARVELDAJA_API_KEY_ID> --env EARVELDAJA_API_PUBLIC_VALUE=<EARVELDAJA_API_PUBLIC_VALUE> --env EARVELDAJA_API_PASSWORD=<EARVELDAJA_API_PASSWORD> --env EARVELDAJA_SERVER=<EARVELDAJA_SERVER> --env EARVELDAJA_ALLOWED_PATHS=<EARVELDAJA_ALLOWED_PATHS> --transport stdio e-arveldaja-mcp -- npx -y e-arveldaja-mcp
```
Replace <…> with your own values. 3 more environment variables are in the server README

### Codex

**Platform CLI**
```bash
codex mcp add e-arveldaja-mcp --env EARVELDAJA_API_KEY_ID=<EARVELDAJA_API_KEY_ID> --env EARVELDAJA_API_PUBLIC_VALUE=<EARVELDAJA_API_PUBLIC_VALUE> --env EARVELDAJA_API_PASSWORD=<EARVELDAJA_API_PASSWORD> --env EARVELDAJA_SERVER=<EARVELDAJA_SERVER> --env EARVELDAJA_ALLOWED_PATHS=<EARVELDAJA_ALLOWED_PATHS> -- npx -y e-arveldaja-mcp
```
Replace <…> with your own values. 3 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "e-arveldaja-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "e-arveldaja-mcp"
            ],
            "env": {
                "EARVELDAJA_API_KEY_ID": "<EARVELDAJA_API_KEY_ID>",
                "EARVELDAJA_API_PUBLIC_VALUE": "<EARVELDAJA_API_PUBLIC_VALUE>",
                "EARVELDAJA_API_PASSWORD": "<EARVELDAJA_API_PASSWORD>",
                "EARVELDAJA_SERVER": "<EARVELDAJA_SERVER>",
                "EARVELDAJA_ALLOWED_PATHS": "<EARVELDAJA_ALLOWED_PATHS>"
            }
        }
    }
}
```
Replace <…> with your own values. 3 more environment variables are in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "e-arveldaja-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "e-arveldaja-mcp"
            ],
            "env": {
                "EARVELDAJA_API_KEY_ID": "<EARVELDAJA_API_KEY_ID>",
                "EARVELDAJA_API_PUBLIC_VALUE": "<EARVELDAJA_API_PUBLIC_VALUE>",
                "EARVELDAJA_API_PASSWORD": "<EARVELDAJA_API_PASSWORD>",
                "EARVELDAJA_SERVER": "<EARVELDAJA_SERVER>",
                "EARVELDAJA_ALLOWED_PATHS": "<EARVELDAJA_ALLOWED_PATHS>"
            }
        }
    }
}
```
Replace <…> with your own values. 3 more environment variables are in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e EARVELDAJA_API_KEY_ID=<EARVELDAJA_API_KEY_ID> -e EARVELDAJA_API_PUBLIC_VALUE=<EARVELDAJA_API_PUBLIC_VALUE> -e EARVELDAJA_API_PASSWORD=<EARVELDAJA_API_PASSWORD> -e EARVELDAJA_SERVER=<EARVELDAJA_SERVER> -e EARVELDAJA_ALLOWED_PATHS=<EARVELDAJA_ALLOWED_PATHS> e-arveldaja-mcp npx -y e-arveldaja-mcp
```
Replace <…> with your own values. 3 more environment variables are in the server README

## When to use it
- create and process an accounting invoice
- import a bank statement into the accounting system
- retrieve a report from accounting records
- plan the steps in an accounting workflow

## Example prompts
- Import this bank statement and help me reconcile its transactions.
- Prepare an accounting invoice and show me the entries before confirmation.
- Suggest a safe sequence of steps for the year-end close.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md