iDoklad runs on your own machine — the client starts it, so there is no endpoint to ping. Last commit 9 Nov 2026.
Unofficial iDoklad invoicing: read and create invoices, proformas, credit notes and contacts.
Today is the operative word: we check iDoklad every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.
This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.
claude mcp add idoklad-mcp -e 'IDOKLAD_CLIENT_ID=<IDOKLAD_CLIENT_ID>' -e 'IDOKLAD_CLIENT_SECRET=<IDOKLAD_CLIENT_SECRET>' -e 'IDOKLAD_APPLICATION_ID=<IDOKLAD_APPLICATION_ID>' -- npx -y idoklad-mcp
{
"mcpServers": {
"idoklad-mcp": {
"command": "npx",
"args": [
"-y",
"idoklad-mcp"
],
"env": {
"IDOKLAD_APPLICATION_ID": "<IDOKLAD_APPLICATION_ID>",
"IDOKLAD_CLIENT_ID": "<IDOKLAD_CLIENT_ID>",
"IDOKLAD_CLIENT_SECRET": "<IDOKLAD_CLIENT_SECRET>"
}
}
}
}
[mcp_servers.idoklad-mcp]
command = "npx"
args = ["-y", "idoklad-mcp"]
env = { IDOKLAD_CLIENT_ID = "<IDOKLAD_CLIENT_ID>", IDOKLAD_CLIENT_SECRET = "<IDOKLAD_CLIENT_SECRET>", IDOKLAD_APPLICATION_ID = "<IDOKLAD_APPLICATION_ID>" }
{
"mcpServers": {
"idoklad-mcp": {
"command": "npx",
"args": [
"-y",
"idoklad-mcp"
],
"env": {
"IDOKLAD_APPLICATION_ID": "<IDOKLAD_APPLICATION_ID>",
"IDOKLAD_CLIENT_ID": "<IDOKLAD_CLIENT_ID>",
"IDOKLAD_CLIENT_SECRET": "<IDOKLAD_CLIENT_SECRET>"
}
}
}
}
{
"servers": {
"idoklad-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"idoklad-mcp"
],
"env": {
"IDOKLAD_APPLICATION_ID": "<IDOKLAD_APPLICATION_ID>",
"IDOKLAD_CLIENT_ID": "<IDOKLAD_CLIENT_ID>",
"IDOKLAD_CLIENT_SECRET": "<IDOKLAD_CLIENT_SECRET>"
}
}
}
}
Put your own values in place of
<IDOKLAD_CLIENT_ID> (Client ID from iDoklad → Settings → API), <IDOKLAD_CLIENT_SECRET> (Client Secret from iDoklad → Settings → API), <IDOKLAD_APPLICATION_ID> (Client Id of a ClientCredentials app on developer.idoklad.cz).
The author’s registry entry marks them as required.
Optional settings from the registry entry, left out of the block above:
IDOKLAD_READ_ONLY (Set to false to enable tools that create or change data (default true)), IDOKLAD_DOWNLOAD_DIR (Folder for downloaded PDFs (default ~/Downloads)).
Read contacts, matters, invoices and documents; create contacts, matters and notes in Docketwise.
Read smallinvoice contacts, invoices, offers, projects and hours; create contacts and invoices.
Read Billy invoices, bills, contacts, products and postings; create contacts and draft invoices.
Read projects, invoices, hours and contacts; register hours, create tasks in Gripp.
Read Billomat clients, invoices, offers, credit notes, reminders; create clients and draft invoices.
Read Lexware Office contacts, articles, invoices and vouchers; create contacts and draft invoices.
Read Oblio clients, products and documents; create proformas, issue, collect and cancel invoices.
Read contacts, invoices and book entries; create contacts and draft invoices in Quipu.
Answers built from our own checks of this server.