iDoklad
Unofficial iDoklad connector: read and create invoices, credit notes and contacts
- 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-mcpAdd 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 → APIRequiredIDOKLAD_CLIENT_SECRETClient Secret from iDoklad → Settings → APIRequiredIDOKLAD_APPLICATION_IDClient Id of a ClientCredentials app on developer.idoklad.czRequiredIDOKLAD_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.

