Skip to content
MCP server

iDoklad

Unofficial iDoklad connector: read and create invoices, credit notes and contacts

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.4.0
Listing updated
today

Similar MCP servers

About iDoklad

iDoklad is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

The server targets iDoklad, a Czech and Slovak online invoicing service, and is not affiliated with iDoklad or its owner. It needs a plan with API access (Popular or Premium; Free and Basic have none), plus a Client ID and Secret from the iDoklad settings and an Application ID from an app created on the developer portal using the ClientCredentials flow. Node.js 22 or newer is required, and the README warns it is in early development at v0.4.

It starts read-only; set IDOKLAD_READ_ONLY=false to unlock write tools. Reads cover issued, proforma and received invoices and credit notes, PDF downloads, contacts, the price list and codebook lists. There are also business overview tools for income and costs, overdue amounts by age, VAT for a period and progress toward the VAT registration limit. Write tools create invoices (optionally copying a previous one's settings), turn a paid proforma into a final invoice, issue credit notes, record or remove payments and send emails and reminders through iDoklad's templates.

To manage several companies, add the server once per company.

Install

Run in a terminal

claude mcp add idoklad-mcp --env IDOKLAD_CLIENT_ID='<IDOKLAD_CLIENT_ID>' --env IDOKLAD_CLIENT_SECRET='<IDOKLAD_CLIENT_SECRET>' --env IDOKLAD_APPLICATION_ID='<IDOKLAD_APPLICATION_ID>' -- npx -y idoklad-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "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>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "idoklad-mcp": {
      "type": "stdio",
      "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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "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>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "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>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • IDOKLAD_CLIENT_IDClient ID from iDoklad → Settings → APIRequired
  • IDOKLAD_CLIENT_SECRETClient Secret from iDoklad → Settings → APIRequired
  • IDOKLAD_APPLICATION_IDClient Id of a ClientCredentials app on developer.idoklad.czRequired
  • IDOKLAD_READ_ONLYSet to false to enable tools that create or change data (default true)
  • IDOKLAD_DOWNLOAD_DIRFolder for downloaded PDFs (default ~/Downloads)

Tools this server provides (26)

Taken from the project documentation; the running server may differ.

list_issued_invoices
List issued invoices, newest first, with filters
list_proforma_invoices
List proforma invoices
list_credit_notes
List credit notes
list_received_invoices
List received invoices by supplier
get_issued_invoice
Full detail of one issued invoice
get_proforma_invoice
Full detail of one proforma invoice
get_credit_note
Full detail of one credit note
get_received_invoice
Full detail of one received invoice
get_document_pdf
Save a document's PDF to the Downloads folder
create_issued_invoice
Create an invoice from defaults or a previous invoice
create_proforma_invoice
Create a proforma invoice
create_invoice_from_proforma
Create the final invoice from a paid proforma
create_credit_note
Credit a whole invoice or selected items
mark_document_paid
Record full payment of a document
mark_document_unpaid
Remove payments from a document
send_document_email
Email an invoice, proforma or credit note
send_payment_reminder
Email an overdue payment reminder
send_payment_confirmation
Email a payment confirmation to a customer
get_business_stats
Income, costs, overdue amounts and VAT for a period
get_top_partners
Biggest customers or debtors
get_contact_stats
How a customer pays
list_contacts
Search contacts by name, IČO, DIČ or email
get_contact
Full detail of one contact
create_contact
Create a customer or supplier
list_price_list_items
Search the price list
get_codebook
Currencies, countries, VAT rates, bank accounts and other lists

What it does

Document listing
Filter invoices by status, customer, date or number.
Invoice creation
Create invoices, proformas and credit notes.
Payment actions
Mark documents paid or unpaid and send reminders.
Business overview
Income, costs, overdue ages and VAT registration progress.
PDF download
Save a document's PDF to a folder.
Read-only default
Write tools stay off until enabled.
Czech and English
Prompts and docs cover both languages.

Good for

  • Find which invoices are overdue
  • Create an invoice for a client based on last month's
  • Issue a credit note for returned licences
  • Send payment reminders for overdue invoices
  • Check how close you are to mandatory VAT registration

Pricing

Open source

Server is open source; needs an iDoklad plan with API access

iDoklad FAQ

Which iDoklad plans work?

Plans with API access: Popular (Oblibeny) or Premium. Free and Basic have no API.

Is it official?

No. The README says it is unofficial and not affiliated with iDoklad or Seyfor.

Can it change my data?

Only if you set IDOKLAD_READ_ONLY to false; it is read-only by default.

What credentials are needed?

A Client ID and Client Secret from iDoklad settings and an Application ID from a ClientCredentials app on developer.idoklad.cz.

Is iDoklad free?

Yes. iDoklad is open source, so you can use and self-host it for free.

How do I add iDoklad to Claude Code?

Run this command in your terminal: claude mcp add idoklad-mcp --env IDOKLAD_CLIENT_ID='<IDOKLAD_CLIENT_ID>' --env IDOKLAD_CLIENT_SECRET='<IDOKLAD_CLIENT_SECRET>' --env IDOKLAD_APPLICATION_ID='<IDOKLAD_APPLICATION_ID>' -- npx -y idoklad-mcp

What are the best alternatives to iDoklad?

The closest alternatives to iDoklad are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Crypto Feeds and Crypto Fng.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers