Katseline, mitteametlik projekt — kasutamine omal vastutusel

Lase tehisintellektil raamatupidamise rutiin ära teha.

Let AI handle the bookkeeping routine.

e-arveldaja MCP server ühendab sinu AI-assistendi otse Eesti e-arveldajaga (RIK). Arved PDF-idest ja piltidest, pangaimport, kuu lõpp ja Eesti maksud — tavakeeles. Sina vaatad üle ja kinnitad.

Vaata GitHubis Kuidas see töötab
133 tööriista tools
15 valmis töövoogu ready workflows
6+ AI-klienti toetatud AI clients supported

Mis see on

Sild AI ja e-arveldaja vahel

e-arveldaja on Eesti riigi raamatupidamistarkvara (RIK). MCP server on väike vahelüli, mis ühendab selle sinu tehisintellekti-assistendiga — olgu selleks Claude, ChatGPT/Codex, Gemini, Cursor või mõni teine.

Tulemus: sa räägid oma assistendiga tavakeeles ja tema teeb e-arveldajas töö ära — loeb arveid PDF-idest ja piltidest, impordib pangaväljavõtteid, sobitab makseid, teeb müügiarveid, koostab aruandeid ja arvutab makse. Sina jääd otsustajaks; assistent teeb rutiini. Töötab nii käibemaksukohustuslastega kui ka mittekohustuslastega.

Päris kõike see siiski ei tee. Igapäevarutiini server katab, aga osa toiminguid — näiteks käibedeklaratsiooni (KMD), TSD-d ja muud Maksu- ja Tolliametiga (EMTA) seonduvat — tee endiselt e-arveldaja veebikeskkonnas.

Server on tasuta ja avatud lähtekoodiga (Apache 2.0). Kood ja kogu dokumentatsioon on GitHubis.

01

Räägi tavakeeles

Speak plainly

„Impordi LHV väljavõte ja sobita arvetega.“ Ei mingit eksporti-importi ega menüüde otsimist.

"Import the LHV statement and match it to invoices." No export-import dance, no hunting through menus.

02

Assistent näitab eelvaadet

The assistant shows a preview

Kõik pakettoperatsioonid käivad esmalt dry-run-režiimis — näed täpselt, mida tehakse, enne kui midagi muutub.

Every batch operation runs in dry-run mode first — you see exactly what will happen before anything changes.

03

Sina kinnitad

You approve

Kanded tehakse alles pärast sinu nõusolekut. Iga muudatus läheb inimloetavasse auditilogisse.

Records are written only after your approval. Every change goes into a human-readable audit log.

Miks ma selle tegin

Algus oli klassikaline „scratching my own itch“ — tahtsin Wise'i ja Lightyeari impordi ning arvete sisestuse endale lihtsamaks teha. Sealt kasvas asi suuremaks.

Nüüd hakkab valmis saama. Kõike see ei tee — käibe- ja TSD-deklaratsioonid jäävad endiselt e-arveldaja veebi kanda — aga teeb päris palju: loeb PDF-id ja pildid arvetena sisse, impordib pangaväljavõtteid, seob kõik kokku, teeb müügiarveid ning kontrollib piirmäärasid ja raamatupidamisreegleid, kus oskab. Ja saad tavakeeles uurida, kuidas su firmal läheb.

Ise majandan sellega paari oma mikrofirmat ja olen juba päris rahul. Liiga palju testitud see veel pole, nii et kontrolli alati üle. Kui teed e-arveldajaga oma mikrofirma raamatupidamist, usun, et on omajagu abiks.

Why I built this

It started as a classic "scratching my own itch" — I wanted to make Wise and Lightyear imports, and entering invoices, easier for myself. It grew from there.

It's starting to come together. It doesn't do everything — VAT and TSD returns still live in the e-arveldaja web UI — but it does quite a lot: it reads PDFs and images as invoices, imports bank statements, ties it all together, creates sales invoices, and checks limits and accounting rules where it can. And you can ask, in plain language, how your company is doing.

I run a couple of my own micro-companies on it and I'm already pretty happy with it. It hasn't been tested extensively yet, so always double-check. If you keep your micro-company's books in e-arveldaja, I think it'll genuinely help.

Indrek Seppo e-arveldaja MCP autor

Mida ta oskab

Võimalused

Igapäevane raamatupidamisrutiin loomuliku vestlusega — lõplik otsus jääb sinu teha.

01

Ostuarved PDF-ist ja pildilt

OCR loeb arve PDF-ist või pildilt (JPG/PNG), tuvastab tarnija äriregistrist, täidab KM-määra ja konto varasemate kannete põhjal, loob ostuarve ja seob selle pangamaksega. OCR võib eksida, nii et kontrolli väljad üle.

Purchase invoices from PDFs and images

OCR reads the invoice from a PDF or image (JPG/PNG), resolves the supplier from the business registry, fills the VAT rate and account from past bookings, creates the purchase invoice and matches it to the bank payment. OCR can misread, so check the fields.

02

Pangaimport (CAMT.053)

Impordi LHV, Swedbanki, SEB, Coopi või Luminori väljavõte. Tunneb ära duplikaadid viitenumbri järgi ja saab hakkama segavaluutadega.

Bank import (CAMT.053)

Import statements from LHV, Swedbank, SEB, Coop or Luminor. Detects duplicates by bank reference and handles mixed currencies.

03

Wise'i tehingud

Impordi Wise'i tehingute CSV — sissetulevad ja väljaminevad maksed, teenustasud eraldatakse omaette kanneteks korrektse kuluarvestuse jaoks.

Wise transactions

Import the Wise transactions CSV — incoming and outgoing payments, with fees split into separate entries for proper expense accounting.

04

Pangaridade sobitamine

Seob laekumised ja maksed õigete arvetega. Ülekannete tuvastamisel ettevaatlik — kahtluse korral jätab kinnitamata, mitte ei oleta.

Bank reconciliation

Matches incoming and outgoing payments to the right invoices. Conservative with transfers — when unsure, it skips rather than guesses.

05

Kuu lõpp ja aruanded

Kuu lõpu kontroll-loend, kasumiaruanne, bilanss, nõuete ja kohustuste vananemine — kuupäevavahemiku järgi, valitud seisuga.

Month-end & reports

Month-end checklist, profit & loss, balance sheet, receivables and payables aging — by date range, as of any chosen date.

06

Eesti maksud

Dividendipakett 22/78 tulumaksuga, jaotamata kasumi ja netovara kontroll (ÄS § 157).

Estonian taxes

Dividend package with 22/78 income tax, retained-earnings and net-asset checks (ÄS §157).

07

Lightyeari investeeringud

Loob kanded Lightyeari tehingutest, dividendidest ja intressidest ning arvutab kapitalikasumi FIFO-aruande põhjal.

Lightyear investments

Creates journal entries from Lightyear trades, dividends and interest, and computes capital gains from the FIFO report.

08

Raamatupidamise „inbox“

Skannib töökausta ja ütleb, mida saab teha automaatselt, mis vajab üht otsust ja mis raamatupidaja pilku. Hea koht, kust alustada.

Accounting "inbox"

Scans your working folder and tells you what can be done automatically, what needs one decision, and what needs an accountant's eye. A good place to start.

09

Müügiarved

Koosta ja saada müügiarveid, halda kliente, artikleid ja arvete seeriaid. Sissetulevad maksed seob hiljem pangaimport ise arvetega.

Sales invoices

Create and send sales invoices, manage clients, articles and invoice series. Incoming payments are later matched to these invoices by the bank import.

Neid ei pea pähe õppima — assistent valib su soovi põhjal ise õige töövoo. Aga kui tahad näha, mis kõik olemas on:

Kõik 15 töövoogu (MCP-promptid)
accounting-inboxAlusta siit: skannib kausta, tuvastab sisendid ja pakub järgmised ohutud sammud.
book-invoiceOstuarve PDF-ist: loe, valideeri, tuvasta tarnija, eelvaade, loo, lae üles, kinnita.
receipt-batchKviitungipakk: loo ja lae üles projekti ostuarved (kinnitus eraldi).
import-camtCAMT.053 väljavõte: eelvaade, kanded pärast kinnitust.
import-wiseWise'i CSV eelvaade: teenustasud, duplikaadid, vahelejätud.
reconcile-bankSobita pangaread arvetega, seejärel autokinnitus või käsitsi ülevaatus.
classify-unmatchedRühmita sobitamata pangaread, eelvaade, rakenda pärast kinnitust.
month-end-closeKuu lõpp: kontroll-loend, proovibilanss, kasumiaruanne, bilanss.
company-overviewFinantsülevaade: bilanss, kasumiaruanne, nõuded, kohustused.
new-supplierLoo tarnija äriregistri otsinguga.
lightyear-bookingKanna Lightyeari tehingud ja väljamaksed CSV-st.
resolve-accounting-reviewTee ülevaatuskirjest konkreetne tegevusplaan.
prepare-accounting-review-actionValmista ette lahendatud kirje järgmine tegevus.
setup-credentialsKontrolli ja impordi API-võti failist apikey.txt.
setup-e-arveldajaSelgita API-võtme seadistust seadistusrežiimis.

Usaldus ja privaatsus

Viimane sõna jääb sinule

Pärisandmetega töötab vaid siis, kui sina lubad — ja jätab jälje.

Dry-run vaikimisi

Dry-run by default

Pangaimport, Wise, Lightyear, kviitungipakid ja autokinnitus näitavad esmalt eelvaadet. Kirjeid muudetakse alles pärast sinu selget kinnitust.

Bank import, Wise, Lightyear, receipt batches and auto-confirm all preview first. Records change only after your explicit approval.

Auditilogi

Audit log

Iga muutev tegevus kirjutatakse inimloetavasse Markdown-logisse (logs/{firma}.audit.md) — ajatempel, tööriist, kontod ja summad.

Every mutating operation is written to a human-readable Markdown log (logs/{company}.audit.md) — timestamp, tool, accounts and amounts.

OCR on liivakastis

OCR is sandboxed

Skannitud arvete tekst pakitakse turvapiiridesse, et pahatahtlik dokument ei saaks su assistendile peidetud käske anda (prompt injection'i kaitse).

Text from scanned invoices is wrapped in security delimiters so a malicious document cannot smuggle hidden instructions to your assistant (prompt-injection protection).

Lokaalne ja kitsas

Local and narrow

Dokumendid loetakse vaikimisi lokaalselt. Server suhtleb väljapoole vaid e-arveldaja API-ga ja sinu valitud AI-mudeliga — ja äriregistriga, kui tarnijat otsid.

Documents are parsed locally by default. The server only reaches out to the e-arveldaja API and your chosen AI model — plus the business registry for supplier lookups.

Järgib varasemaid kandeid

Follows past bookings

Uurib enne, kuidas sarnased kanded on varem tehtud, ja teeb siis samamoodi. KM-käsitlust ta ise välja ei mõtle.

It first checks how similar entries were booked before, then does the same. It doesn't invent VAT treatment on its own.

Mitu ettevõtet

Multiple companies

Mitu API-võtit kõrvuti, lülitumine ühe käsuga. Ettevõtte vahetamisel tühjendatakse vahemälu, et andmed ei seguneks.

Several API keys side by side; switch with one command. Switching clears the cache so data doesn't get mixed between companies.

Oluline — kasutamine omal vastutusel

See on katseline ja mitteametlik projekt — testitud, aga mitte üleliia palju. See ei ole seotud RIK-iga ega e-arveldaja teenusega ega ole nende poolt heaks kiidetud. Tarkvara töötab pärisandmetega ning võib luua, muuta, kinnitada ja kustutada raamatupidamiskirjeid. Kontrolli alati tulemused üle. Autor ei vastuta andmekao ega valede kannete eest.

Tehniline seadistus

Käima saab umbes 5 minutiga

Vajad e-arveldaja kontot, MCP-toega AI-assistenti ja Node.js 18+.

1

Võta e-arveldajast API-võti

Get an API key from e-arveldaja

Logi sisse e-arveldajasse → Seadistused → Üldised seadistused → Lisa uus juurdepääsuluba. Lisa oma avalik IP-aadress ja salvesta. Laadi alla fail apikey.txt. Ära kunagi lisa seda faili gitti.

Log in to e-arveldaja → Settings → General settings → Add new access token. Add your public IP address and save. Download the apikey.txt file. Never commit this file to git.

2

Lisa MCP server

Add the MCP server

Enamik AI-assistente oskab serveri ise paika panna — ütle lihtsalt: „Lisa e-arveldaja MCP server, pakett on npm-is: e-arveldaja-mcp.“

Most AI assistants can set the server up for you — just say: "Add the e-arveldaja MCP server, the npm package is e-arveldaja-mcp."

Kui eelistad käsitsi — Claude Code'is piisab ühest reast:

If you prefer to do it manually — in Claude Code, one line is enough:

$ claude mcp add e-arveldaja -- npx -y e-arveldaja-mcp

Muudes klientides (Cursor, Windsurf, Cline, Gemini CLI, Codex CLI, Antigravity) lisa sama oma MCP-seadistusse — või lase assistendil fail ise luua:

In other clients (Cursor, Windsurf, Cline, Gemini CLI, Codex CLI, Antigravity) add the same to your MCP config — or let the assistant create the file for you:

{ "mcpServers": { "e-arveldaja": { "command": "npx", "args": ["-y", "e-arveldaja-mcp"] } } }

Soovitus — lisa server projektipõhiselt. e-arveldaja MCP toob iga vestluse algul mudeli konteksti kõik 133 tööriista; see on püsiv token-kulu igas seansis. Lisa server seetõttu ainult sinna kausta, kus raamatupidamist teed. claude mcp add teeb seda vaikimisi — server kehtib ainult selles projektis. Väldi globaalset paigaldust (-s user): muidu laeksid kõik tööriistad konteksti igas projektis, ka raamatupidamisega mitteseotutes, ja kulutaksid asjata tokeneid. Teistes klientides eelista samuti projektisisest seadistust (nt Cursoris .cursor/mcp.json) globaalse asemel.

Kui sa investeeringuid ei jälgi, saad konteksti veelgi kärpida: keskkonnamuutuja EARVELDAJA_DISABLE_LIGHTYEAR=1 eemaldab Lightyeari tööriistad.

3

Impordi võti ja alusta

Import the key and start

Pane apikey.txt töökausta. Server tunneb selle ära ja pakub importi — või ütle assistendile: „Impordi mu API-võti failist apikey.txt.“ Seejärel proovi: „Skanni see kaust ja ütle, mida saab automaatselt teha.“

Put apikey.txt in your working folder. The server detects it and offers to import — or tell your assistant: "Import my API key from apikey.txt." Then try: "Scan this folder and tell me what can be done automatically."

Töötab nende klientidega

Claude Code Codex CLI Gemini CLI Cursor Windsurf Cline Antigravity
GitHub — kood & juhend npm pakett

Tahad enne päris andmeid proovida? Sea EARVELDAJA_SERVER=demo ja server töötab e-arveldaja demoserveris.

Vajad abi seadistamise või kohandamisega? Kirjuta Indrekule.

Korduma kippuvad küsimused

KKK

Mis on e-arveldaja MCP server?
Avatud lähtekoodiga tööriist (MCP server), mis ühendab sinu AI-assistendi (Claude, Codex, Gemini, Cursor jt) Eesti e-arveldaja (RIK) API-ga. Saad tavakeeles suheldes lasta sisestada ostuarveid PDF-idest ja piltidest, importida pangaväljavõtteid, sobitada makseid ning koostada aruandeid.
What is the e-arveldaja MCP server?
An open-source tool (MCP server) that connects your AI assistant (Claude, Codex, Gemini, Cursor and others) to Estonia's e-arveldaja (RIK e-Financials) API. In plain language it can enter purchase invoices from PDFs and images, import bank statements, match payments and generate reports.
Kas see on RIK-i ametlik tööriist?
Ei. See on katseline ja mitteametlik projekt. See ei ole seotud RIK-iga ega e-arveldaja teenusega ega ole nende poolt heaks kiidetud. Kasutamine on omal vastutusel — kontrolli alati tulemused üle.
Is this an official RIK tool?
No. It is an experimental, unofficial project. It is not affiliated with, endorsed by, or connected to RIK or the e-arveldaja / e-Financials service. Use it at your own risk — always verify the results.
Kas raamatupidajat pole enam vaja?
Tööriist teeb rutiini ära, kuid vastutus jääb sinule. Hea on lasta raamatupidajal aeg-ajalt kanded üle vaadata; vähemalt küsi assistendilt, kas kuskil on kahtlaseid kohti. Raamatupidamisteadmised kuluvad kindlasti ära — ilma nendeta on tulemusi raske hinnata.
Do I still need an accountant?
The tool handles the routine, but the responsibility is yours alone. It's wise to have an accountant review the entries from time to time; at the very least, ask the assistant whether anything looks off. Some accounting knowledge definitely helps — without it, the results are hard to judge.
Kas minu raamatupidamisandmed on turvalised?
Dokumendid loetakse vaikimisi lokaalselt ja server suhtleb väljapoole vaid e-arveldaja API-ga ja sinu valitud AI-mudeliga. Pakettoperatsioonid käivad esmalt dry-run-režiimis (eelvaade), kirjeid muudetakse alles pärast sinu kinnitust ning iga muudatus läheb auditilogisse. Skannitud arvete tekst on prompt injection'i vastu turvapiiretega kaitstud.
Is my accounting data safe?
Documents are parsed locally by default, and the server only reaches out to the e-arveldaja API and your chosen AI model. Batch operations run in dry-run mode first (a preview); records change only after your approval, and every change is written to an audit log. Text from scanned invoices is protected against prompt injection with security delimiters.
Kui palju e-arveldaja MCP server maksab?
Server ise on tasuta ja avatud lähtekoodiga (Apache 2.0). Maksad ainult oma AI-assistendi (näiteks Claude) kasutuse eest, kui see teenus on tasuline. Hea teada: server toob iga seansi konteksti kõik 133 tööriista, seega lisa ta pigem projektipõhiselt (mitte globaalselt) — nii ei kuluta sa tokeneid raamatupidamisega mitteseotud projektides.
How much does the e-arveldaja MCP server cost?
The server itself is free and open source (Apache 2.0). You only pay for your AI assistant (for example Claude) if it is a paid service. Good to know: the server loads all 133 tools into context each session, so add it per project (not globally) — that way you don't spend tokens in projects unrelated to accounting.
Milliste AI-klientidega see töötab?
Iga MCP-toega kliendiga: Claude Code, Codex CLI, Gemini CLI, Cursor, Windsurf, Cline, Antigravity ja teised. Vaja on Node.js 18+.
Which AI clients does it work with?
Any MCP-capable client: Claude Code, Codex CLI, Gemini CLI, Cursor, Windsurf, Cline, Antigravity and others. Node.js 18+ is required.
Milliseid panku ja andmeid see toetab?
Pangaväljavõtted CAMT.053 vormingus (LHV, Swedbank, SEB, Coop, Luminor) ning Wise'i tehingute CSV, samuti Lightyeari investeeringud. Lisaks ostuarved PDF-idest ja piltidest, aruanded ja Eesti maksud (dividendid 22/78, omaniku kulud).
Which banks and data does it support?
Bank statements in CAMT.053 format (LHV, Swedbank, SEB, Coop, Luminor) and the Wise transactions CSV, plus Lightyear investments. On top of that: purchase invoices from PDFs and images, reports and Estonian taxes (dividends 22/78, owner expenses).
Kas server näeb mu algbilanssi?
Mitte automaatselt — e-arveldaja API algbilanssi välja ei anna (nagu mõnda muudki asja). Lihtsaim lahendus: kopeeri algbilanss assistendile ja palu see mällu kirjutada. Edaspidi oskab ta sellega arvestada.
Can it see my opening balance?
Not automatically — the e-arveldaja API doesn't expose the opening balance (along with a few other things). The simplest fix: paste the opening balance to your assistant and ask it to remember it. From then on it can take it into account.