UOL Účetnictví (unofficial)
Unofficial MCP server for UOL Účetnictví: invoices, receivables, VAT and ledger lookups
- 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-mcpAdd 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 demoRequiredUOL_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 demoRequiredUOL_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.

