# iDoklad

> iDoklad is an open-source MCP server for finance and payments. Unofficial iDoklad connector: read and create invoices, credit notes and contacts. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Repository:** https://github.com/honzsik/idoklad-mcp
- **MCP Registry name:** io.github.honzsik/idoklad-mcp
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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

## 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.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Crypto Feeds](https://ai-powered.com/mcp/crypto-feeds): Crypto Feeds is a freemium MCP server for finance and payments.
- [Crypto Fng](https://ai-powered.com/mcp/crypto-fng): Crypto Fng is a freemium MCP server for finance and payments.
- [Creditcard](https://ai-powered.com/mcp/creditcard): Creditcard is a freemium MCP server for finance and payments.
- [Zovo LEI Lookup](https://ai-powered.com/mcp/zovo-lei-lookup): Zovo LEI Lookup is an MCP server for finance and payments.
- [Recurly](https://ai-powered.com/mcp/recurly): Recurly is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/idoklad
