doklado-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
doklado-mcp
Unofficial MCP server for Doklado, the Slovak invoicing app. Not made or supported by Doklado s.r.o., it only uses their public APIs. It lets Claude (or any MCP client) find invoices, download PDFs, email invoices and send or receive e-invoices (eFaktúra) over Peppol.
It wraps two Doklado APIs:
API | What for | Auth |
Public API | invoices, PDFs, email | API key |
SAPI+ (optional) | eFaktúra over Peppol | OAuth client id and secret |
Requirements
Node.js 24 or newer (runs the TypeScript directly, no build step)
A Doklado account with an API key (Prehľad účtu → API prepojenia)
For eFaktúra: a SAPI+ connection (Prehľad účtu → SAPI+ prepojenia). The company needs eFaktúra activated first, see Doklado SAPI+ docs.
Related MCP server: myinvois-mcp
Install
git clone https://github.com/brano-osif/doklado-mcp.git
cd doklado-mcp
npm installPut your secrets in an env file outside the repo, for example ~/.doklado.env:
DOKLADO_API_KEY=...
DOKLADO_SAPI_CLIENT_ID=...
DOKLADO_SAPI_SECRET=...Claude Code
claude mcp add doklado-mcp -s user \
-e DOKLADO_ICO=<your IČO> \
-- node --env-file=$HOME/.doklado.env $PWD/src/index.tsClaude Desktop (extension, easiest)
Download
doklado-mcp.mcpbfrom the latest release, or build it withnpm run bundle.Double-click
doklado-mcp.mcpb, or drag it into Claude Desktop → Settings → Extensions.Fill in the form: API key, IČO, Test mode if the keys are from the sandbox, and optionally the SAPI+ Client ID and Secret for eFaktúra. Secrets are stored in the system keychain.
To change a key later, open Settings → Extensions → Doklado.
Claude Desktop (manual config)
Add this to ~/Library/Application Support/Claude/claude_desktop_config.json (Windows: %APPDATA%\Claude\claude_desktop_config.json) inside mcpServers, then quit Claude Desktop completely and reopen it:
"doklado-mcp": {
"command": "/opt/homebrew/bin/node",
"args": ["/path/to/doklado-mcp/src/index.ts"],
"env": {
"DOKLADO_ICO": "<your IČO>",
"DOKLADO_API_KEY": "...",
"DOKLADO_SAPI_CLIENT_ID": "...",
"DOKLADO_SAPI_SECRET": "..."
}
}Use absolute paths. Claude Desktop does not use your shell's PATH, so command must be the full path from which node. To share the keys with Claude Code, put them in the env file instead and add "--env-file=/Users/<you>/.doklado.env" as the first arg. Don't paste this file anywhere when it contains keys. Logs are in ~/Library/Logs/Claude/mcp-server-doklado-mcp.log.
Other MCP clients
Run node --env-file=<file> src/index.ts as a stdio server with the same variables.
Configuration
Variable | Required | Meaning |
| yes | Public API key |
| yes | IČO of your company in Doklado |
| no |
|
| no |
|
| for eFaktúra | SAPI+ client id |
| for eFaktúra | SAPI+ client secret |
The eFaktúra tools appear when both SAPI variables are set. If only one is set, the server prints a warning to its log and starts without them. Your DIČ (Peppol id 0245:<DIČ>) is read from your company in Doklado, so it has to be filled in there.
Keys are per environment. A sandbox key does not work in production. Sandbox web app: efaktura-sandbox.doklado.sk.
Tools
Tool | What it does |
| List invoices and receipts with filters, paginated |
| Full detail of one document |
| Edit an issued invoice |
| Save the invoice PDF to |
| Email the invoice PDF |
| Issue a new invoice (only with |
| Can a company receive eFaktúra? (by DIČ) |
| Send a Peppol BIS 3 UBL invoice or credit note |
| Delivery status of a sent eFaktúra and its report to Finančná správa |
| List received eFaktúry |
| Save a received eFaktúra XML to |
| Mark a received eFaktúra as processed |
Tool descriptions carry the details Claude needs (filters, quirks, a validated UBL pattern).
Costs
Doklado bills API usage. As of November 2026:
Public API: 1 € per started 1,000 units, 1,000 a month included in Doklado PLUS. Listing costs 1 unit per document read, so filter by date.
issue_invoiceuses the separate "Vystavenie faktúr cez API" module, 14.90 € a month. That is why it is off by default.eFaktúra through the Doklado postman has no extra fee, each one counts as a document in your plan.
See Doklado API pricing.
Safety
Calls that change data (update, email, send eFaktúra) are never retried after a timeout or network error, the tool says to verify first. The only automatic retry is one fresh SAPI+ login after a 401, which Doklado rejects before doing anything.
send_einvoiceuses an idempotency key derived from your Peppol id, the customer's and the invoice number, so resending the same invoice never delivers it twice, even if the XML is rebuilt.The server never logs keys or tokens.
Development
src/index.ts MCP server wiring
src/config.ts environment variables
src/api/ Doklado Public API and SAPI+ clients
src/tools/ tool definitions and their descriptions
src/types/ shared types
src/utils/ request, Peppol helpers, downloads, OpenAPI schemasCode style follows Prettier (npm run format).
npm run check # type check
npm run lint # Prettier check
npm run format # Prettier fix
npm test # runs against the sandbox, needs a sandbox env file
npm run bundle # builds doklado-mcp.mcpb for Claude Desktopnpm test runs against the Doklado sandbox. Put your sandbox values in .env.test (ignored by git):
DOKLADO_SANDBOX=true
DOKLADO_ICO=...
DOKLADO_DIC=...
DOKLADO_API_KEY=...
DOKLADO_SAPI_CLIENT_ID=... # optional, enables the eFaktúra checks
DOKLADO_SAPI_SECRET=...It only reads data and checks errors. It does not issue invoices or send email.
Releasing
Bump
versioninpackage.jsonandmanifest.json.Commit, then tag and push:
git tag v1.4.0 && git push origin v1.4.0.GitHub Actions type checks, builds
doklado-mcp.mcpband attaches it to a new release. It fails if the tag and the two versions differ.
Contributing
Issues and pull requests are welcome, see CONTRIBUTING.md. Report security problems privately as described in SECURITY.md.
Disclaimer
Unofficial project, not affiliated with Doklado s.r.o. openapi.json is Doklado's public API specification from api-doc.doklado.sk, included so tool schemas match the API.
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Fakturownia.pl (Polish invoicing) via MCP: invoices, clients, products, warehouse. Full read-write.
wFirma.pl (Polish accounting) via MCP: invoices, contractors, payments, reports. Full read-write.
MCP server for ABRA Flexi — accounting, contacts, stock and draft-checked invoice creation.
Validate, generate, convert and extract EN 16931 e-invoices for businesses.
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server for creating and fiscalizing invoices via solo.com.hr API. Enables AI agents to generate invoices, retrieve invoice details, list invoices, and check next invoice number.4MIT
- AlicenseNot gradedqualityCmaintenanceEnables issuing and managing validated Malaysian e-invoices via MyInvois (LHDN) directly from MCP clients, with tools for TIN validation, invoice drafting, submission, and document management.24 npm3Do What The F*ck You Want To Public
- AlicenseAqualityCmaintenanceEnables issuing invoices, proformas, and delivery notices, collecting payments, submitting e-Factura to Romania's SPV, and querying reference data on Oblio.eu through natural language from MCP clients.12MIT
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients to browse KSeF invoice metadata for a chosen period, fetch a single invoice's original XML by its KSeF number, and export invoices into a folder as XML, PDF, or Markdown. Authenticates with a KSeF certificate and supports seller, invoice-number, and date-type filters.30 npm1MIT