Datovka Multibox
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Datovka Multibox List all unread messages from the last week in my primary box."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Datovka Multibox
K čemu je projekt dobrý
Datovka Multibox propojuje AI asistenta s několika českými datovými schránkami. Pomáhá vyřizovat osobní i firemní korespondenci: vybrat správný účet, načíst zprávy, najít příjemce a připravit odpověď s přílohami. Odesílání vyžaduje kontrolu konkrétního návrhu v místním okně. Přístup máte pouze přes vlastní nastavené účty a jejich oprávnění.
Veřejná část slouží ke sdílení programu. Soukromá část je místní instalace s vašimi účty, oprávněními a návrhy. Obě používají stejné jádro, takže opravy není nutné udržovat dvakrát. Účty a hesla nejsou součástí veřejného repozitáře.
Related MCP server: mcp-server-datovka
Podpora vývoje
Moje úpravy a údržbu této odvozené verze můžete dobrovolně podpořit na Buy Me a Coffee. Příspěvek není podmínkou používání. Původní projekt vytvořilo Sensio.cz; odkaz podporuje tuto odvozenou verzi.
Místní MCP konektor pro více českých datových schránek. Odvozeno z projektu Sensio-cz/mcp-datovka, viz UPSTREAM.md.
Verze 0.2.0 je základ připravený pro doplnění vlastních účtů. Offline testy ověřují ochrany a sestavení SOAP požadavků. Funkčnost s opravdovými schránkami zatím nebyla ověřena. Před ostrým provozem proveďte zkoušku v testovacím ISDS.
Veřejná a soukromá varianta
Veřejná část je tento repozitář: zdrojový kód, plugin, testy a vzor konfigurace. Soukromá varianta používá stejné jádro s místním nastavením. Nevzniká druhá větev s hesly, kterou by bylo možné omylem sloučit do veřejné verze.
Na Windows jsou účty a návrhy standardně v %LOCALAPPDATA%\DatovkaMultibox.
Na ostatních systémech v ~/.local/share/DatovkaMultibox. Umístění lze změnit
absolutní cestou v DATOVKA_PRIVATE_DIR; musí být mimo repozitář.
Hesla ukládá knihovna keyring do systémového úložiště (na Windows Credential
Manager). Hesla nejsou v JSON, argumentech nástrojů ani v konfiguraci MCP.
Soubor config.example.json obsahuje pouze smyšlený příklad.
Instalace na Windows
Potřebujete Python 3.11 nebo novější. V kořeni projektu spusťte:
./scripts/install.ps1
./scripts/nastavit-ucet.ps1První příkaz vytvoří oddělené .venv a prázdnou soukromou konfiguraci.
Druhý interaktivně přidá účet; lze ho opakovat pro další schránky. Heslo se
zadává skrytě v místním terminálu. Testovací prostředí je výchozí, produkční
se volí výslovně. Příjem i odesílání se povolují zvlášť. Přidání účtu se
nepřipojuje k ISDS a není ověřením správnosti přihlašovacích údajů.
Současná verze podporuje jméno a heslo ISDS. Bankovní identita, Mobilní klíč, SMS a certifikát v této verzi implementované nejsou. Neměňte si kvůli tomu bez rozmyslu nastavení zabezpečení účtu.
Připojení k AI klientovi
Balíček obsahuje kompatibilní manifest .codex-plugin/plugin.json, .mcp.json
a dovednost v skills/. Po instalaci závislostí lze kořen projektu přidat jako
místní plugin. Instalace uloží cestu k běhovému prostředí do soukromého
runtime.json, aby fungovala i kopie pluginu v mezipaměti klienta.
Samotné zveřejnění na GitHubu jej nenainstaluje do Codexu ani
nezveřejní v katalogu OpenAI.
V Codex CLI lze po instalaci závislostí zaregistrovat repozitář a plugin:
codex plugin marketplace add petrkosekmb-commits/mcp-datovka-multibox
codex plugin add datovka-multibox@datovka-multibox-communityPo instalaci otevřete nový chat. Při aktualizaci kódu zopakujte také
scripts/install.ps1, aby se aktualizovalo místní běhové prostředí.
Pro běžného MCP klienta použijte absolutní cestu k
.venv/Scripts/python.exe (Windows), argumenty -m mcp_datovka a stdio.
Soukromá data nejsou součástí pluginu. Na Linuxu vytvořte .venv pomocí
python3 -m venv .venv, instalujte .venv/bin/python -m pip install . a
zajistěte funkční systémové úložiště hesel a Tk pro kontrolní okno.
Práce se schránkami
datovka_list_boxes: místní seznam účtů bez sítě.datovka_list_received,datovka_list_sent: seznamy z výslovně zvolené schránky.datovka_read_message: stažení přijaté zprávy včetně příloh v base64.datovka_search_box: hledání příjemce přes zvolený účet.datovka_prepare_message: místní neměnný návrh, bez odeslání.datovka_get_draft: celý text, odesílatel, příjemce, přílohy a stav.datovka_send_draft: jediný pokus o odeslání schváleného návrhu.
U příloh lze do JSON pole files zadat buď file_path s absolutní cestou,
nebo filename, mime_type a content_base64. Při přípravě se obsah uloží
do návrhu; pozdější změna původního souboru odesílaný návrh nezmění.
Text je příloha text-zpravy.txt, i když zpráva obsahuje další soubory.
Místní limit je 20 MiB a 50 přidaných příloh, nikoli tvrzení o limitu ISDS.
Kontrola a odeslání
Připravte návrh a zkontrolujte schránku, prostředí, ID příjemce a obsah.
Otevřete místní kontrolní okno:
./.venv/Scripts/python.exe -m mcp_datovka.setup review ID_NAVRHUUživatel v okně schválí konkrétní návrh. Schválení samo nic neodesílá.
AI může zavolat
datovka_send_draftpouze s ID schváleného návrhu.
Návrh čeká na schválení nejvýše 24 hodin; po schválení platí 15 minut. Odesílatel je svázán s ID schránky, přihlašovacím jménem a prostředím. Před odesláním se přes ISDS kontroluje, zda přihlášení odpovídá ID schránky. Jakákoli změna obsahu vyžaduje nový návrh a nové schválení.
Stav sent znamená, že ISDS vrátilo ID zprávy; není to potvrzení jejího
doručení adresátovi. sending po pádu procesu a uncertain po chybě vyžadují
ruční kontrolu odeslaných zpráv. Automatický druhý pokus je blokován.
Záměrně tu není nástroj MCP pro schválení. Jde o ochranu na hranici MCP,
nikoli proti programu se stejnými plnými právy k místním souborům a klávesnici.
Doručení a soukromí
Načtení příchozích zpráv může způsobit doručení a běh lhůt. Vypnuté odesílání tomu samo nebrání. Příjem se proto povoluje zvlášť. Není tu automatický plánovač synchronizace. Viz příručka Datovky.
Návrhy a jejich přílohy jsou v místní SQLite databázi bez aplikačního šifrování; chraňte uživatelský profil a disk. Hesla jsou v systémovém úložišti zvlášť. Obsah vrácený MCP klientovi může být odeslán jeho poskytovateli AI podle nastavení klienta. Místní server sám neznamená, že obsah zůstává pouze v PC. Archivace ZFO, doručenek a zálohování na NAS zatím nejsou implementované.
Vývoj a ověření
./.venv/Scripts/python.exe -m pip install pytest build
./.venv/Scripts/python.exe -m pytest -q
./.venv/Scripts/python.exe -m build --wheelTesty používají smyšlené účty a blokují síťové požadavky. Ověřují výběr účtu, povolování příjmu, neměnnost návrhu, expiraci, souběh, blokování opakovaného odeslání, chyby ISDS a skládání příloh. CI běží na Windows a Linuxu.
Licence původního kódu: MIT, viz LICENSE. Původ převzatých definic WSDL/XSD a odlišné licence závislostí jsou uvedeny v UPSTREAM.md.
Available Tools
8 toolsdatovka_get_draftBRead-only
Vrati uplny text, hashe priloh a stav navrhu bez site.
Inputs: draft_id (required).
datovka_list_boxesARead-only
Mistni seznam uctu bez pripojeni k ISDS a bez prihlasovacich udaju.
Inputs: no named parameters. Returns: result
datovka_list_receivedBDestructive
Nacte prijate zpravy. Muze zpusobit doruceni; vyzaduje povoleny prijem.
Inputs: box_alias (required), from_date, max_results. Returns: result
datovka_list_sentCDestructive
Nacte odeslane zpravy z vybraneho uctu. Vyzaduje povoleny sitovy prijem.
Inputs: box_alias (required), from_date, max_results. Returns: result
datovka_prepare_messageA
Ulozi nemenny navrh lokalne; nic neodesila. files je JSON pole priloh.
Zobrazte uplny nahled. Schvaleni pouze v mistnim okne prikazem datovka-config review ID. Nevydavejte pripravu za odeslani.
Inputs: subject (required), to_box_id (required), from_box_alias (required), body, +1 more.
datovka_read_messageBDestructive
Stahne prijatou zpravu s prilohami base64; muze zpusobit doruceni.
Inputs: box_alias (required), message_id (required).
datovka_search_boxCDestructive
Vyhleda prijemce pres explicitne zvoleny ucet. Zadny ucet se nehada.
Inputs: query (required), box_alias (required), box_type. Returns: result
datovka_send_draftADestructive
Odesle pouze lokalne schvaleny nemenny navrh, nejvyse jeden pokus.
Po chybe nejprve overte odeslane zpravy. Nevytvarejte automaticky novy navrh pro opakovani. Schvaleni nema MCP nastroj.
Inputs: draft_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
The read path (list_boxes, list_received, list_sent, read_message) and the write path (prepare_message, get_draft, send_draft) are cleanly separated, and the immutability/approval semantics are spelled out. The only real overlap is datovka_search_box versus datovka_list_boxes, which an agent could confuse since both concern data boxes; the descriptions disambiguate but require careful reading.
Every tool uses the datovka_ prefix with a consistent snake_case verb_noun pattern (list_received, read_message, prepare_message, send_draft, get_draft). The verb choices map predictably to action semantics: list for collections, get for a single known artifact, read for content retrieval.
Eight tools is well-scoped for a mail/data-box client, with each tool covering a distinct step in the receive-compose-approve-send workflow. Nothing looks redundant, and the split between prepare_message, get_draft, and send_draft is justified by the immutable-draft design.
Core lifecycle is covered for received mail and for outgoing drafts, but the surface has notable gaps: sent messages can be listed yet never read in full (read_message is receive-only), there is no way to delete or discard a draft, and no message-level search or attachment enumeration beyond reading a message. Approval being outside MCP is a deliberate design choice rather than a gap, but the read side of outbound mail remains a dead end.
Maintenance
Related MCP Connectors
Hosted email MCP for your own Gmail, Outlook.com, Microsoft 365, iCloud or IMAP inbox: read, search, draft, reply in thread, forward and file mail. It moves or flags up to 500 messages in one call, and a send leaves exactly one copy in Sent. A calendar is a separate connection, and connecting one adds diary and scheduling tools.
Your IMAP mailbox as an MCP server: read, search and (if you allow it) organize mail. Open source.
Your mailbox for MCP clients: search, read, draft, send, rules and notes. Sending is off by default.
Private, EU-hosted email for AI agents over JMAP: read, search, reply, draft, organize, send.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server for accessing Czech datové schránky (ISDS) with legal semantics. Enables AI agents to safely read, send, and archive messages while respecting delivery triggers and deadlines.3MIT
- AlicenseNot gradedqualityBmaintenanceAn MCP server exposing the Czech ISDS Data Box system (Datové schránky) as tools, built on fastmcp and python3-datovka.1LGPL 3.0
- FlicenseNot gradedqualityCmaintenanceProvides secure, draft-first IMAP/SMTP access to a GMX business mailbox over Streamable HTTP, letting users list folders, read, search and download attachments, and create, update or delete drafts and replies. Sending is never arbitrary: it requires an explicit user-approved send of a previously reviewed draft, and email content is always treated as untrusted data.-
- AlicenseNot gradedqualityCmaintenanceEnables searching, reading, sending, replying to, forwarding, and organizing email across multiple SMTP/IMAP accounts.MIT