Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words Sign in

iDoklad

by honzsikversion 0.4.0i★ 0iRuns on your computerRepository ↗
Registry nameio.github.honzsik/idoklad-mcp

How to install

What it does

Unofficial iDoklad invoicing: read and create invoices, proformas, credit notes and contacts.

  • Connects Runs on your computer
  • Account or key Needs IDOKLAD_CLIENT_SECRET · 2 settings to fill in (IDOKLAD_CLIENT_ID, IDOKLAD_APPLICATION_ID)
  • Category Accounting, finance & tax

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity0/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score12/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install iDoklad. Follow https://mcp.popnx.com/i/honzsik-idoklad-mcp.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

You need a iDoklad key (create it on the maker’s site) · 2 setting(s) to fill in (IDOKLAD_CLIENT_ID, IDOKLAD_APPLICATION_ID) · Only the Claude desktop app (Windows or Mac), not the web or phone

  1. Download the maker’s installer

    Download the maker’s .mcpb file

    The .mcpb file comes straight from the maker; we do not change it

  2. Double-click the file, then click Install in the Claude desktop app

  3. Try it

    Use iDoklad and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using iDoklad or shows a iDoklad tool in the answer, you are connected

2 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • 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)

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect iDoklad yet

iDoklad runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect iDoklad

  • You need a iDoklad key (create it on the maker’s site) · 2 setting(s) to fill in (IDOKLAD_CLIENT_ID, IDOKLAD_APPLICATION_ID) · Only the Claude desktop app (Windows or Mac), not the web or phone
  • You need a iDoklad key (create it on the maker’s site) · 2 setting(s) to fill in (IDOKLAD_CLIENT_ID, IDOKLAD_APPLICATION_ID) · Install Node.js on your computer first (one time)
  • You need a iDoklad key (create it on the maker’s site) · 2 setting(s) to fill in (IDOKLAD_CLIENT_ID, IDOKLAD_APPLICATION_ID) · Install Node.js on your computer first (one time)
  • You need a iDoklad key (create it on the maker’s site) · 2 setting(s) to fill in (IDOKLAD_CLIENT_ID, IDOKLAD_APPLICATION_ID) · Install Node.js on your computer first (one time)

B · Others in Accounting, finance & tax that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code, with some setup first

You need a iDoklad key (create it on the maker’s site) · 2 setting(s) to fill in (IDOKLAD_CLIENT_ID, IDOKLAD_APPLICATION_ID) · Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server iDoklad for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user idoklad --env IDOKLAD_CLIENT_ID=your-value --env IDOKLAD_CLIENT_SECRET=your-value --env IDOKLAD_APPLICATION_ID=your-value -- npx -y idoklad-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For IDOKLAD_CLIENT_SECRET, IDOKLAD_CLIENT_ID, IDOKLAD_APPLICATION_ID, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the iDoklad tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Sign up and create a iDoklad key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the iDoklad site ↗

  3. Fill in 2 setting(s)

    These are program settings, not keys. No sign-up needed; fill them in as the maker describes.

    • IDOKLAD_CLIENT_ID Client ID from iDoklad → Settings → API
    • IDOKLAD_APPLICATION_ID Client Id of a ClientCredentials app on developer.idoklad.cz

    Descriptions are as written by the maker.

  4. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  5. Paste this command and press Enter

    claude mcp add --scope user idoklad --env IDOKLAD_CLIENT_ID=your-value --env IDOKLAD_CLIENT_SECRET=your-value --env IDOKLAD_APPLICATION_ID=your-value -- npx -y idoklad-mcp

    Replace “your-value” with your key before pressing Enter

    Paste the key only into the app’s field, never into a chat or to anyone

  6. Type /mcp in Claude Code

    You should see iDoklad listed as connected

  7. Try it

    Use iDoklad and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using iDoklad or shows a iDoklad tool in the answer, you are connected

2 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • 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)

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

You need a iDoklad key (create it on the maker’s site) · 2 setting(s) to fill in (IDOKLAD_CLIENT_ID, IDOKLAD_APPLICATION_ID) · Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server iDoklad for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "idoklad": { "command": "npx", "args": [ "-y", "idoklad-mcp" ], "env": { "IDOKLAD_CLIENT_ID": "your-value", "IDOKLAD_CLIENT_SECRET": "your-value", "IDOKLAD_APPLICATION_ID": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For IDOKLAD_CLIENT_SECRET, IDOKLAD_CLIENT_ID, IDOKLAD_APPLICATION_ID, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the iDoklad tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Sign up and create a iDoklad key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the iDoklad site ↗

  3. Fill in 2 setting(s)

    These are program settings, not keys. No sign-up needed; fill them in as the maker describes.

    • IDOKLAD_CLIENT_ID Client ID from iDoklad → Settings → API
    • IDOKLAD_APPLICATION_ID Client Id of a ClientCredentials app on developer.idoklad.cz

    Descriptions are as written by the maker.

  4. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  5. Fill in your key

    In the iDoklad settings, IDOKLAD_CLIENT_SECRET, IDOKLAD_CLIENT_ID, IDOKLAD_APPLICATION_ID is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  6. Open the AI chat in Cursor in Agent mode

  7. Try it

    Use iDoklad and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using iDoklad or shows a iDoklad tool in the answer, you are connected

2 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • 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)

Descriptions are as written by the maker.

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

You need a iDoklad key (create it on the maker’s site) · 2 setting(s) to fill in (IDOKLAD_CLIENT_ID, IDOKLAD_APPLICATION_ID) · Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server iDoklad for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "idoklad": { "type": "stdio", "command": "npx", "args": [ "-y", "idoklad-mcp" ], "env": { "IDOKLAD_CLIENT_ID": "your-value", "IDOKLAD_CLIENT_SECRET": "your-value", "IDOKLAD_APPLICATION_ID": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For IDOKLAD_CLIENT_SECRET, IDOKLAD_CLIENT_ID, IDOKLAD_APPLICATION_ID, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the iDoklad tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Sign up and create a iDoklad key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the iDoklad site ↗

  3. Fill in 2 setting(s)

    These are program settings, not keys. No sign-up needed; fill them in as the maker describes.

    • IDOKLAD_CLIENT_ID Client ID from iDoklad → Settings → API
    • IDOKLAD_APPLICATION_ID Client Id of a ClientCredentials app on developer.idoklad.cz

    Descriptions are as written by the maker.

  4. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  5. Fill in your key

    In the iDoklad settings, IDOKLAD_CLIENT_SECRET, IDOKLAD_CLIENT_ID, IDOKLAD_APPLICATION_ID is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  6. Open the AI chat in VS Code in Agent mode

  7. Try it

    Use iDoklad and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using iDoklad or shows a iDoklad tool in the answer, you are connected

2 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • 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)

Descriptions are as written by the maker.

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use iDoklad💬 Discussion →
For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user idoklad --env IDOKLAD_CLIENT_ID=your-value --env IDOKLAD_CLIENT_SECRET=your-value --env IDOKLAD_APPLICATION_ID=your-value -- npx -y idoklad-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "idoklad": {
      "command": "npx",
      "args": [
        "-y",
        "idoklad-mcp"
      ],
      "env": {
        "IDOKLAD_CLIENT_ID": "your-value",
        "IDOKLAD_CLIENT_SECRET": "your-value",
        "IDOKLAD_APPLICATION_ID": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "idoklad": {
      "command": "npx",
      "args": [
        "-y",
        "idoklad-mcp"
      ],
      "env": {
        "IDOKLAD_CLIENT_ID": "your-value",
        "IDOKLAD_CLIENT_SECRET": "your-value",
        "IDOKLAD_APPLICATION_ID": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "idoklad": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "idoklad-mcp"
      ],
      "env": {
        "IDOKLAD_CLIENT_ID": "your-value",
        "IDOKLAD_CLIENT_SECRET": "your-value",
        "IDOKLAD_APPLICATION_ID": "your-value"
      }
    }
  }
}

Values you fill in

  • IDOKLAD_CLIENT_ID required env
    Client ID from iDoklad → Settings → API
  • IDOKLAD_CLIENT_SECRET secret required env
    Client Secret from iDoklad → Settings → API
  • IDOKLAD_APPLICATION_ID required env
    Client Id of a ClientCredentials app on developer.idoklad.cz
  • IDOKLAD_READ_ONLY env
    Set to false to enable tools that create or change data (default true)
  • IDOKLAD_DOWNLOAD_DIR env
    Folder for downloaded PDFs (default ~/Downloads)

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
Not on npm/PyPI
Connection
Runs on your computer
Latest versioni
0.4.0
Published to registryi
Nov 9, 2026
Code last changedi
Nov 9, 2026
Maker
honzsik
Packages
npm: idoklad-mcp
mcpb: …/idoklad-mcp-0.4.0.mcpb
Website
github.com
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 20, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account honzsik, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 11 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for idoklad-mcp@0.4.0

Checks only this package version, not every dependency · checked Nov 16, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/honzsik-idoklad-mcp.svg)](https://mcp.popnx.com/en/servers/honzsik-idoklad-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Accounting, finance & taxi

  • More stars than 0% of the other 3496 servers in this category
  • Published to the registry more recently than 73% of the other 3496 servers in this category
  • Basic checks equal to or better than 99% of the other 3496 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is iDoklad safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: IDOKLAD_CLIENT_SECRET

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 11 days ago, and the latest version (0.4.0) reached the registry 11 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js, MCPB on your computer.

What can I use instead?

In the same category: SolidInvoice, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP, Twelve Data

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

by SolidInvoiceGrowing★ 990Updated 11 days ago

Runs in the cloud✓ service owner · solidinvoice.co

Journalit

Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.

by CursivezGrowing★ 265Updated 12 days ago

Runs in the cloud✓ service owner · journalit.co

Beancount.io

Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.

by bex-coGrowing★ 707 Stars for the whole repoUpdated last month

Runs in the cloud✓ service owner · beancount.io

Twelve Data

Real-time and historical market data: stocks, forex, crypto, ETFs, fundamentals and 60+ indicators.

by twelvedataGrowing★ 87Updated 16 days ago

Runs in the cloud✓ service owner · twelvedata.com
Compared with similar ones
This one
iDoklad
SolidInvoiceJournalitBeancount.ioTapetide - Indian Stock Market MCPTwelve Data
Runs whereInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installCloud or install on your computerRuns in the cloud, nothing to install
Needs a keyYesNoNoNoYesNo
Add with + in ClaudeNoNoNoNoNoYes
Basic checks3/34/64/44/45/54/4
LicenseMITMITNOASSERTIONMITMIT–
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

idoklad-mcp

An unofficial MCP server for iDoklad, the Czech and Slovak online invoicing service. It lets Claude, Codex, Cursor and other AI assistants read and create invoices in your iDoklad account.

[!NOTE]

This project is not affiliated with or endorsed by iDoklad or Seyfor, a. s.

🇨🇿 Návod v češtině

[!WARNING]

Early development (v0.4). Tools and their inputs may still change. See the roadmap.

What you can ask

  • *"Which invoices are overdue?"*
  • *"How much has ACME paid us this year?"*
  • *"Download the PDF of the last invoice for Globex."*
  • *"Which received invoices haven't we paid yet?"*
  • *"Kdo mi dluží nejvíc?"* / *"Jak se mi letos daří oproti loňsku?"*
  • *"Kolik mi zbývá do povinné registrace k DPH?"*
  • *"Create an invoice for ACME s.r.o.: 10 hours of consulting at 1,500 CZK, due in 14 days."* (needs write mode)
  • *"Invoice Globex like last month, but for 42 hours."* (copies currency, VAT and language from the previous invoice)
  • *"Mark invoice 20260018 as paid today."*
  • *"Send payment reminders for all overdue invoices."*
  • *"Issue a credit note for invoice 20260015, the client returned 2 of the 10 licences."*

Requirements

  • An iDoklad plan that includes API access: Oblíbený (Popular) or Prémiový (Premium). The Free and Basic plans have no API.
  • Node.js 22 or newer.
  • An MCP client: Claude Desktop, Claude Code, Codex, Cursor, VS Code or similar.

Setup

1. Get your credentials

You need three values. They take about five minutes to get.

Client ID and Client Secret, from iDoklad:

  1. Sign in to app.idoklad.cz.
  2. Go to Nastavení (Settings) → API.
  3. Copy the Client ID and Client Secret.

These belong to one company (agenda) and one user.

Application ID, from the iDoklad developer portal:

  1. Create an account at developer.idoklad.cz.
  2. Under Nová aplikace, enter any name and set Flow to ClientCredentials. Then click Uložit.
  3. Copy the new app's Client Id from the list. That value is your Application ID.

[!IMPORTANT]

The app must use the ClientCredentials flow. With an AuthorizationCode app, iDoklad rejects the login with Invalid parameter application_id.

2. Add the server to your AI client

Replace the ... placeholders with your three values.

Claude Code

claude mcp add idoklad \

-e IDOKLAD_CLIENT_ID=... \ -e IDOKLAD_CLIENT_SECRET=... \ -e IDOKLAD_APPLICATION_ID=... \ -- npx -y idoklad-mcp

Claude Desktop (one-click install)

  1. Download the latest idoklad-mcp- .mcpb from Releases.
  2. Double-click the file, or drag it into Claude Desktop → Settings → Extensions.
  3. Click Install, then fill in your Client ID, Client Secret and Application ID.

The extension is read-only by default. You can switch that off in its settings.

Claude Desktop (manual config)

Open Settings → Developer → Edit Config and add:

{

"mcpServers": { "idoklad": { "command": "npx", "args": ["-y", "idoklad-mcp"], "env": { "IDOKLAD_CLIENT_ID": "...", "IDOKLAD_CLIENT_SECRET": "...", "IDOKLAD_APPLICATION_ID": "..." } } } }

Restart Claude Desktop afterwards.

Codex

Add to ~/.codex/config.toml:

[mcp_servers.idoklad]

command = "npx" args = ["-y", "idoklad-mcp"]

[mcp_servers.idoklad.env] IDOKLAD_CLIENT_ID = "..." IDOKLAD_CLIENT_SECRET = "..." IDOKLAD_APPLICATION_ID = "..."

Cursor, VS Code and other clients

Use the same command, args and env values as in the Claude Desktop example, in your client's MCP settings.

3. Try it

Ask your assistant *"Which of my iDoklad invoices are unpaid?"*

Configuration

VariableRequiredDefaultDescription
IDOKLAD_CLIENT_IDyesFrom iDoklad → Settings → API
IDOKLAD_CLIENT_SECRETyesFrom iDoklad → Settings → API
IDOKLAD_APPLICATION_IDyesThe Client Id of your ClientCredentials app on developer.idoklad.cz
IDOKLAD_READ_ONLYnotrueSet to false to enable tools that create or change data
IDOKLAD_DOWNLOAD_DIRno~/DownloadsFolder where downloaded PDFs are saved

To use several companies, add the server once per company under different names (for example idoklad-firma-a and idoklad-firma-b), each with that company's credentials.

Read-only by default

Out of the box, the server can only read your data. To let the assistant create or change documents, set:

IDOKLAD_READ_ONLY=false

Write tools are marked as such, so clients can ask you to confirm before running them.

Tools

Documents: issued invoices, proforma invoices, credit notes, received invoices.

ToolModeWhat it does
list_issued_invoicesreadList issued invoices (vydané faktury), newest first. Filter by unpaid, paid, partly paid or overdue, customer, issue date or number.
list_proforma_invoicesreadSame for proforma invoices (zálohové faktury).
list_credit_notesreadSame for credit notes (dobropisy).
list_received_invoicesreadSame for received invoices (přijaté faktury), filtered by supplier.
get_issued_invoice, get_proforma_invoice, get_credit_note, get_received_invoicereadFull detail of one document: items, partner and totals.
get_document_pdfreadSave a document's PDF to your Downloads folder, optionally in another language or with payments.
create_issued_invoicewriteCreate an invoice from your default settings, or copy a previous invoice's settings. Supports currency (exchange rate filled in automatically), language, VAT rate and due date.
create_proforma_invoicewriteSame for proforma invoices (zálohové faktury).
create_invoice_from_proformawriteCreate the final invoice from a paid proforma (vyúčtování zálohy).
create_credit_notewriteCredit a whole invoice or selected items, with a reason. It can also settle the credit note against the invoice.
mark_document_paidwriteRecord full payment of an invoice, proforma or received invoice.
mark_document_unpaidwriteRemove payments, so the document is unpaid again.
send_document_emailwriteEmail an invoice, proforma or credit note through iDoklad, using your iDoklad email template.
send_payment_reminderwriteEmail an overdue payment reminder (upomínka) using your iDoklad reminder template.
send_payment_confirmationwriteEmail a customer a confirmation that their payment arrived.

Business overview

ToolModeWhat it does
get_business_statsreadIncome and costs by month, quarter or year, this year against last year, overdue amounts by age, VAT for the period, progress toward the VAT registration limit, and document counts.
get_top_partnersreadBiggest customers, or biggest debtors.
get_contact_statsreadHow a customer pays: invoices, paid, unpaid and late.

Contacts and price list

ToolModeWhat it does
list_contactsreadSearch contacts by name, IČO, DIČ or email.
get_contactreadFull detail of one contact.
create_contactwriteCreate a customer or supplier.
list_price_list_itemsreadSearch the price list (ceník) by name or code.

Everything else

ToolModeWhat it does
get_codebookreadCurrencies, countries, VAT rates, payment options, your bank accounts, numeric sequences and other lists.
search_api_docsreadSearch the full iDoklad API reference, which is bundled with the server.
idoklad_api_requestread / writeCall any iDoklad endpoint directly, e.g. bank statements, recurring invoices or stock. In read-only mode it only allows GET.

Privacy and security

  • The server runs on your computer. Your credentials stay in your local client configuration and are only sent to iDoklad.
  • Data the assistant reads from iDoklad, such as invoices and contacts, is passed to the AI model you use, just like anything else you share in the chat.
  • Treat your Client Secret like a password. Never commit it or paste it into a chat. To revoke it, delete it in iDoklad → Settings → API.

Troubleshooting

MessageFix
Missing environment variables: …One of the three credentials is not set in your client configuration.
Invalid parameter application_idYour developer portal app doesn't use the ClientCredentials flow, or you copied the wrong value. Use the app's Client Id.
iDoklad login failed (HTTP 400)Check the Client ID and Secret in iDoklad → Settings → API. They may have been regenerated.
HTTP 402Your iDoklad plan doesn't include the API, or your subscription has expired.
HTTP 429You've hit iDoklad's rate limit: 200 requests per minute, and a monthly quota that depends on your plan. The server retries on its own; wait and try again.

Roadmap

  • Issued invoices: list, detail, create
  • Currency for new invoices, and copying a previous invoice
  • Proforma invoices, credit notes, received invoices
  • Contacts and price list items
  • Payments (mark as paid or unpaid)
  • PDF download and sending documents by email
  • Generic tools: call any iDoklad endpoint, search the API docs
  • Create proforma invoices and credit notes, and invoices from paid proformas
  • Business overview: revenue, debtors, VAT, VAT registration limit
  • Payment reminders and payment confirmations
  • Partial payments
  • Supplier invoices from a PDF (iDoklad inbox)
  • Bank matching, editing and deleting documents, recurring invoices
  • One-click install for Claude Desktop, and a listing in the MCP Registry
  • Hosted version with iDoklad login (OAuth) for claude.ai and ChatGPT

Ideas and requests are welcome in issues.

Development

git clone https://github.com/honzsik/idoklad-mcp.git

cd idoklad-mcp npm install cp .env.example .env # add your credentials

CommandWhat it does
npm testUnit tests against a fake API, with no network calls
npm run test:liveRead-only checks against your real iDoklad account (uses .env)
npm run smokeCalls the read tools through a real MCP connection
npm run evalsChecks that Claude picks the right tools for 30 Czech and English requests (see below)
npm run inspectOpens the tools in MCP Inspector
npm run buildCompiles to dist/
npm run build:api-indexRefreshes the bundled API reference from iDoklad's docs
npm run build:mcpbBuilds the Claude Desktop extension (idoklad-mcp- .mcpb)
Evals

evals/ checks whether Claude picks the right tool, with the right inputs, for real requests such as *"Které faktury jsou po splatnosti?"* or *"Invoice Globex like last time, but for 42 hours"*. Each case runs as a short conversation against a made-up iDoklad company, so no real data is touched. It also checks that Claude doesn't send emails or change documents unless asked.

Only the beginning is shown; read the rest in the repo