Do your Merit Aktiva accounting from the command line — or let Claude Code do it for you. Merit Aktiva is Estonia's cloud accounting platform.
> /plugin marketplace add Elnora-AI/elnora-merit-aktiva> /plugin install merit-aktiva-workspace@elnora-merit-aktiva
Repo: Elnora-AI/elnora-merit-aktiva
What's inside
Do your Merit Aktiva accounting from the command line — or let Claude Code do it for you.
Merit Aktiva is Estonia's cloud accounting platform. This repo gives you two ways to drive its API:
elnora-merit — a CLI that covers the entire Merit Aktiva API (invoices, payments, VAT/KMD, ledger, reports, and more) plus Merit Palk payroll. JSON in, JSON out.Everything is universal — nothing about any one company is hardcoded. Point it at your own Merit credentials and it works.
Requires a Merit Aktiva Pro or Premium license — the API is not available on lower tiers.
npm install -g @elnora-ai/merit-aktiva
This puts the elnora-merit command on your PATH. Node.js ≥ 20 required.
Paste these two slash commands into Claude Code one at a time — wait for the first to finish before the second:
/plugin marketplace add Elnora-AI/elnora-merit-aktiva
/plugin install merit-aktiva-workspace@elnora-merit-aktiva
The plugin uses the elnora-merit CLI under the hood, so install that first.
The plugin ships three agents that wrap the CLI with guardrails — resolve the customer, build per-rate VAT totals, preview the payload, gate on your approval:
| When you ask to… | Agent |
|---|---|
| create / bill a sales invoice | merit-aktiva-workspace:merit-invoice-creator |
| record a payment, enter a purchase invoice, reconcile open items | merit-aktiva-workspace:merit-bookkeeper |
| look up a company (legal name / VAT / address / e-invoice capability) | merit-aktiva-workspace:merit-company-lookup |
A host that only loads the merit-* skills gets a recipe and then hand-runs the CLI itself — skipping those guardrails. To make the agents fire at the right time, add one routing rule to your host's own instructions (Claude Code CLAUDE.md, AGENTS.md, .cursorrules, or persistent agent memory), e.g.:
For Merit write/lookup work (create invoice, record payment, enter purchase, reconcile, company lookup) dispatch the
merit-aktiva-workspaceagent above — do not hand-run theelnora-meritCLI. Read/report/VAT work (KMD, reports, Stripe/LHV import, reverse charge, payroll) has no agent — use themerit-*skills directly.
That write-vs-read split is the whole rule: agent-first only where an agent exists.
Generate an API ID and API Key in Merit Aktiva: Settings → Company data → API settings → "Koosta võti" (Generate key).
The CLI reads them from environment variables. On first run it also prompts and saves them to ~/.config/elnora-merit/.env (mode 0600):
export MERIT_API_ID=your-api-id
export MERIT_API_KEY=your-api-key
Or copy .env.template to .env and fill it in (.env is gitignored — never commit it).
| Variable | Required | Notes |
|---|---|---|
MERIT_API_ID | yes | GUID from API settings |
MERIT_API_KEY | yes | base64 secret; the HMAC signing key |
MERIT_API_VERSION | no | v1 (default) or v2 for dual-version endpoints |
MERIT_PALK_API_ID | for palk | Merit Palk API ID (separate payroll product) |
MERIT_PALK_API_KEY | for palk | Merit Palk API key (base64 secret) |
MERIT_REFERENCES_DIR | no | Base dir for config + reference files (stripe map, ledger, overrides, company-profile.json). Default ~/.config/elnora-merit. |
Snapshot your account's own chart of accounts, banks, VAT codes, and financial years so an agent (or you) can look up the real codes without transcribing them by hand:
elnora-merit profile sync # → company-profile.json (in MERIT_REFERENCES_DIR)
elnora-merit profile show --section taxes # the VAT TaxId guids, etc.
company-profile.json holds no secrets but is company-specific, so it is gitignored.
Re-run profile sync whenever the chart of accounts changes.
This step is entirely optional. Everything else in the CLI and the Merit agent works
without it. Setting it up just adds one extra capability: the elnora-merit ariregister
commands, which pull company data straight from the Estonian Business Register (äriregister)
using RIK's free ("tasuta") API services — so an agent can fill a new customer's legal
name, VAT number, and address, and check e-invoice capability, from the authoritative source
instead of asking you.
One of the two lookups needs no setup at all:
# e-invoice capability — works with NO credentials:
elnora-merit ariregister e-invoice-check 16818352
The requisite lookup needs a free äriregister contract + login. To enable it:
Register for the free API tier. Go to rik.ee → e-äriregister → XML teenus and conclude a contract for the "Ainult e-äriregistri tasuta API-teenused" (free API services only) tier at the e-äriregister portal. You log in with an Estonian ID-card / Mobiil-ID / Smart-ID. The free tier has no per-query cost. See RIK's contractual-client admin guide.
Create an XML-authorised user. In the portal: Haldus → Kasutajate haldamine → Lisa
kasutaja, and enable XML/API access for it. (Optionally set the credit limit to 0 so
only free services can ever run.)
Get the username + password. The username is shown in the users table; generate the password with the "Uus parool" button (note: this XML-service password is separate from your portal login, and a freshly generated one can take ~10 minutes to activate).
Save them to ~/.config/elnora-merit/.env (mode 0600, gitignored — never commit):
ARIREG_XML_USER=YOURUSERNAME
ARIREG_XML_PASSWORD=your-xml-service-password
Then both lookups work:
elnora-merit ariregister requisites 16818352 # → name, VAT, status, address
elnora-merit ariregister e-invoice-check 16818352 # → OK/MR + e-invoice operator
Only the free services are exposed; billable queries (detailed data, beneficial owners,
representation rights) are intentionally excluded. See the merit-company-lookup skill/agent.
Optional. Everything else works without it. Connecting it automates the other half of the books: instead of exporting a statement file from your internet bank and uploading it, your agent pulls the statement from LHV directly and imports it into Merit.
LHV (AS LHV Pank) publishes its own read-only MCP server, and this plugin already bundles it — there is nothing to install and no key to add. Just connect it:
/mcp, pick lhv, choose Authenticate.accounts:read
and transactions:read.The token lives in your own MCP client for 30 days. This plugin never sees or stores it, and LHV exposes no write scope at all — an assistant can read your accounts and can never move money. Revoke any time: internet bank → Settings → Active sessions.
What the connection gives you:
| Ask your agent | What it uses |
|---|---|
| "What's our balance?" | every account — IBAN, currency, available balance |
| "How much is actually available vs reserved?" | available, settled, and reserved balance per IBAN |
| "What did we spend on X last month?" | totals, top counterparties, income vs spend (max 31 days) |
| "Show me last week's transactions" | the full statement — what came in, what went out |
| "Import July's statement into Merit" | the statement as camt.053, straight into payments import-statement — no file export |
The last one is the point: LHV returns a real ISO 20022 camt.053 statement, which is
exactly what Merit's bank import accepts, so the bank and the books talk to each other with no
file in between. The merit-lhv skill drives it — and its first step is checking whether
the period is already booked, because importing an already-booked month double-books it.
Estonia-only, and only for LHV customers. Other banks: export camt.053 from your internet bank
and use payments import-statement --file as usual.
elnora-merit accounts list # chart of accounts
elnora-merit banks list # bank accounts
elnora-merit taxes list # VAT rates
elnora-merit customers list --name "Acme" # find a customer
elnora-merit sales-invoices list --period-start 2026-01-01 --period-end 2026-03-31
elnora-merit reports income-statement --end-date 20260331 --per-count 3
# Output controls (work on any command)
elnora-merit accounts list --output table --fields Code,Name
elnora-merit accounts list --pretty # pretty JSON
Creating documents. Create/send commands take the Merit JSON body via --data (inline) or --file (path). Each command's --help lists the required fields:
elnora-merit sales-invoices create --file invoice.json
See the official Merit reference manual for field details.
Full coverage of the Merit Aktiva REST API — 22 resource groups — plus four local helpers: profile (snapshot your account's codes), reconcile (book Stripe payouts), documents (audit + attach missing receipts), and ariregister (free Estonian Business Register lookups). Run elnora-merit <group> --help for per-command options and payload schemas.
| Group | Commands |
|---|---|
sales-invoices | list, find, get, create, create-v2, create-credit, create-multi-payment, create-from-xml, get-pdf, send-email, send-einvoice, delete |
sales-offers | list, get, create, create-v1, update, set-status, create-invoice |
recurring-invoices | create, list, get, list-client-addresses, send-indication-values |
purchase-invoices | create, create-pending, create-pending-xml, list, find, list-pending, get, delete, pay, report |
inventory | list, list-locations, send, send-v1 |
payments | list, find, list-types, create, create-purchase, create-offer, delete, list-income, list-expense, send-income, send-expense, send-prepayment, send-prepayment-vendor, send-settlement, import-statement, list-imports |
gl | create, list, get, list-full |
fixed-assets | list, list-locations, list-responsible-persons, send |
taxes | list, create |
customers | list, create, update, create-group, list-groups |
vendors | list, create, update, update-v1, create-group, list-groups |
accounts | list |
projects | list |
cost-centers | list |
dimensions | list, create, create-values |
departments | list |
prices | list, get, send, list-discounts, send-discounts |
units | list, create |
banks | list |
financial-years | list |
items | list, list-groups, create, create-group, update |
View @elnora-ai’s profileThe full Linear API as a CLI, a Claude Code plugin, and a signal-driven hygiene curator — purpose-built for AI coding agents to create, edit, review, and curate Linear issues safely at scale.
@elnora-aiFAQ
merit-aktiva-workspace is a Claude Code plugin with 18 hand-picked skills for automation work, indexed on Flowy. Install it with the command on its page. It includes merit-aktiva-workspace, merit-business-trips, merit-company-lookup. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
Is this plugin yours?
Claim it with GitHubSubmit a pluginPromote it