The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Doklad.ai listing page.
Connect AI assistants to Doklad.ai, Czech invoicing software for freelancers (OSVČ) and small companies. The hosted Doklad.ai MCP server lets Claude, ChatGPT, Codex, Claude Code, Cursor, VS Code, Gemini CLI and other Model Context Protocol clients create and send invoices, manage customers, log expenses, record received payments and summarise cash flow in your Doklad.ai account.
| Endpoint | https://doklad.ai/mcp |
| Transport | Streamable HTTP |
| Authentication | OAuth 2.1 (sign in with your Doklad.ai account; PKCE, dynamic client registration) or an API key Authorization: Bearer dk_… |
| Price | Doklad.ai is currently free, MCP included |
| Rate limit | 60 requests per minute per company |
| Official MCP Registry | ai.doklad/mcp |
| Setup guide (Czech) | https://doklad.ai/mcp-fakturace |
This repository holds documentation and client configuration only. The MCP server is hosted and operated by Doklad.ai, so there is nothing to install or run on your side.
Every client uses the same URL, https://doklad.ai/mcp. On first use the client opens Doklad.ai in your browser: sign in, pick the company and allow access. No key is copied anywhere. Only the owner or an admin of a company can grant access.
Add the connector, or open Customize → Connectors → Add custom connector, enter https://doklad.ai/mcp and sign in. The connector then works on the web, in Claude Desktop and in the mobile app. Free plans allow one custom connector; on Team and Enterprise an Owner adds it under Organization settings → Connectors.
Turn on Settings → Security and login → Developer mode, then open chatgpt.com/plugins, click +, enter https://doklad.ai/mcp with OAuth authentication and sign in. Developer mode is available on Plus, Pro, Business, Enterprise and Edu.
Then run /mcp, select doklad and choose Authenticate.
Install in Cursor, or add to ~/.cursor/mcp.json:
Add to .vscode/mcp.json (VS Code 1.99+):
Then run /mcp auth doklad. This repository is also a Gemini CLI extension (gemini-extension.json).
Create a key in Doklad.ai under Integrace → API klíče a webhooky → MCP server and send it as Authorization: Bearer dk_…:
Claude Desktop's claude_desktop_config.json only runs local servers, so use the mcp-remote bridge (Node.js 20.18+):
| Tool | What it does | Access |
|---|---|---|
list_invoices | List invoices, filtered by status, customer, text search or date range | Read |
get_invoice | One invoice with line items and customer details | Read |
create_invoice | Create an invoice: customer, line items (description, quantity, unit price, VAT rate) and due date | Write |
update_invoice | Update an invoice; only the fields you pass change | Write |
delete_invoice | Delete an invoice (drafts and cancelled invoices only) | Destructive |
send_invoice_email | Email an invoice to the customer | Write, sends email |
get_invoice_pdf_url | Download URL of an invoice PDF | Read |
record_payment | Record a received payment against an invoice (bookkeeping entry, moves no money) | Write |
list_customers | Search customers by name, IČO or email | Read |
get_customer | One customer | Read |
create_customer | Create a customer | Write |
update_customer | Update a customer | Write |
list_expenses | List expenses, optionally by status | Read |
get_expense | One expense | Read |
create_expense | Record an expense | Write |
get_invoice_stats | Invoice counts: total, paid, sent, overdue, drafts | Read |
get_cash_flow_summary | Revenue, expenses and profit for a period | Read |
Every tool carries MCP annotations (title, readOnlyHint, destructiveHint, openWorldHint), so clients ask for confirmation before tools that change data or send email.
iss. Discovery: https://doklad.ai/.well-known/oauth-protected-resource/mcp.Návod k připojení v češtině: https://doklad.ai/mcp-fakturace (Claude, ChatGPT, Codex, Claude Code, Cursor, VS Code, Gemini CLI, n8n).
podpora@doklad.ai · https://doklad.ai
The documentation and configuration files in this repository are MIT licensed. The Doklad.ai service is subject to its terms and privacy policy.