Skip to content
MCP server

UOL Účetnictví (unofficial)

Unofficial MCP server for UOL Účetnictví: invoices, receivables, VAT and ledger lookups

Runs locallyStatus and history
Install
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
0.7.0
Listing updated
today

Similar MCP servers

About UOL Účetnictví (unofficial)

UOL Účetnictví (unofficial) is an MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

This community-built server is not affiliated with UOL a.s. and talks to the public UOL REST API with your own API token. It is read-only by default, with writes switched on explicitly, and it respects the API's limit of 30 requests per 10 seconds. A demo mode uses UOL's public demo company so you can try it without a token.

Beyond raw lookups, get_business_snapshot answers how the company is doing in one call, and receivables and VAT overviews report who owes money and what is due per filing period. The server knows API quirks, for example that invoice status valid means draft and that revenue must be read from the ledger excluding year-end closing entries. Extra toolsets for ledger, banking and warehouse data are opt-in, and prompts such as monthly_review, vat_check and overdue_followup are included.

It runs via npx, Docker or a Claude Desktop extension, and can be self-hosted over HTTP. Questions can be asked in Czech or English.

Install

Run in a terminal

claude mcp add uol --env UOL_TENANT='<UOL_TENANT>' --env UOL_TOKEN='<UOL_TOKEN>' -- npx -y uol-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "uol": {
      "command": "npx",
      "args": [
        "-y",
        "uol-mcp"
      ],
      "env": {
        "UOL_TENANT": "<UOL_TENANT>",
        "UOL_TOKEN": "<UOL_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "uol": {
      "command": "npx",
      "args": [
        "-y",
        "uol-mcp"
      ],
      "env": {
        "UOL_TENANT": "<UOL_TENANT>",
        "UOL_TOKEN": "<UOL_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "uol": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "uol-mcp"
      ],
      "env": {
        "UOL_TENANT": "<UOL_TENANT>",
        "UOL_TOKEN": "<UOL_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "uol": {
      "command": "npx",
      "args": [
        "-y",
        "uol-mcp"
      ],
      "env": {
        "UOL_TENANT": "<UOL_TENANT>",
        "UOL_TOKEN": "<UOL_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "uol": {
      "command": "npx",
      "args": [
        "-y",
        "uol-mcp"
      ],
      "env": {
        "UOL_TENANT": "<UOL_TENANT>",
        "UOL_TOKEN": "<UOL_TOKEN>"
      }
    }
  }
}

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

Configuration

  • UOL_TENANTTenant name (https://firma.ucetnictvi.uol.cz → firma), a full https://….uol.cz URL, or demoRequired
  • UOL_EMAILE-mail of the UOL user (not needed for demo)
  • UOL_TOKENUOL API token from /api_tokens (not needed for demo)
  • UOL_TENANTTenant name (https://firma.ucetnictvi.uol.cz → firma), a full https://….uol.cz URL, or demoRequired
  • UOL_EMAILE-mail of the UOL user (not needed for demo)
  • UOL_TOKENUOL API token from /api_tokens (not needed for demo)

Tools this server provides (18)

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

get_business_snapshot
Summarise company performance, VAT, receivables and documents
get_financial_overview
Revenue, expenses and profit per month from the ledger
get_vat_overview
VAT per filing period
get_bank_balances
Bank balances per account and currency
get_company
Company details and connection check
search_sales_invoices
Search issued invoices
get_sales_invoice
Fetch one issued invoice
search_purchase_invoices
Search received invoices
get_purchase_invoice
Fetch one received invoice
list_receivables
List who owes money and how overdue
export_sales_invoice
Export an issued invoice as PDF or ISDOC
search_contacts
Search customers and suppliers
get_contact
Fetch one contact
list_uploaded_documents
List documents uploaded for the accountant
get_uploaded_document
Fetch one uploaded document
download_uploaded_document
Download an uploaded document
list_codebook
List currencies, departments, contracts and similar codebooks
api_get
Read-only GET of another API endpoint

What it does

Business snapshot
Summarises this month against last, VAT, receivables and documents to process.
VAT overview
Shows VAT per filing period with due date and estimate status.
Receivables list
Lists who owes how much and how overdue, per currency.
Invoice export
Saves issued invoices as PDF or ISDOC.
Opt-in toolsets
Ledger, banking and warehouse tools are enabled by variable.
Several companies
One server can hold multiple UOL accounts with separate access levels.

Good for

  • Asking how the company is doing this year
  • Finding customers who are more than 30 days overdue
  • Checking VAT due for the quarter
  • Downloading the PDF of the latest issued invoice
  • Drafting overdue reminders without sending them

Pricing

Pricing unknown

Needs a UOL Účetnictví account and API token; demo company available

UOL Účetnictví (unofficial) FAQ

Is it official?

No, it is unofficial and not endorsed by UOL a.s.

Can I try it without a token?

Yes, set UOL_TENANT=demo to use UOL's public demo company.

Does it write data?

Only if write or full access is enabled; the default is read.

How do I install it?

Through npx, a Docker image or the .mcpb extension for Claude Desktop.

How do I add UOL Účetnictví (unofficial) to Claude Code?

Run this command in your terminal: claude mcp add uol --env UOL_TENANT='<UOL_TENANT>' --env UOL_TOKEN='<UOL_TOKEN>' -- npx -y uol-mcp

What are the best alternatives to UOL Účetnictví (unofficial)?

The closest alternatives to UOL Účetnictví (unofficial) 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