Spacemail MCP propojuje vašeho AI asistenta (například Claude) s vaší schránkou Spacemail. Díky tomu může asistent zobrazit seznam vašich složek, vypisovat, vyhledávat a číst vaše e-maily, označovat je jako přečtené nebo oblíbené, přesouvat je mezi složkami nebo do Koše a odesílat, odpovídat na a přeposílat e-maily z vaší vlastní adresy — vy se ptáte běžným jazykem a asistent volá správné nástroje.
Potřebujete schránku Spacemail. Spacemail MCP je k dispozici na adrese https://mcp.spacemail.com/mcp.
Způsob připojení závisí na vašem AI asistentovi:
Claude (web a desktop) — otevřete Nastavení, zvolte Connectors, přidejte vlastní konektor a nasměrujte jej na https://mcp.spacemail.com/mcp. Anthropic Claude je klient, u kterého jsme ověřili, že Spacemail MCP funguje.
Ostatní MCP klienti — přidejte vzdálený MCP server a nasměrujte jej na https://mcp.spacemail.com/mcp. Ostatní klienti mohou fungovat, ale zatím jsme je neověřili.
Při připojení budete vyzváni k přihlášení a schválení přístupu asistenta k vaší poštovní schránce. Asistent pak jedná pouze v této schránce a pouze prostřednictvím níže uvedených nástrojů.
Obsah e-mailu je nedůvěryhodný. Předměty, odesílatelé, náhledy a těla zpráv píší jiní lidé. Spacemail MCP říká asistentovi, aby s nimi zacházel jako s daty, ne jako s pokyny, ale e-mail se jej přesto může pokusit navést: před schválením změny zkontrolujte, co asistent navrhuje.
Odeslaný e-mail je skutečný e-mail.email_send, email_reply a email_forward odesílají z vaší vlastní adresy Spacemail a odeslaný e-mail nelze vzít zpět. Asistent by měl odeslat pouze to, o co jste požádali: před schválením odeslání zkontrolujte příjemce a text.
Pouze prostý text. Text nového e-mailu, odpovědi nebo přeposlání píšete jako prostý text. Nemůžete nahrávat přílohy, ukládat koncepty ani odesílat zabezpečené zprávy; přeposlaná zpráva může obsahovat přílohy e-mailu, který přeposílá.
Nic se nemaže trvale. Smazání e-mailu jej přesune do složky Koš, odkud jej můžete přesunout zpět. Žádný nástroj Koš nevysypává ani nemaže zprávu.
Smlouvy a zásady, které se vztahují na Spacemail MCP:
Přístup:Čtení pouze získává informace. Zápis mění vaši schránku způsobem, který můžete vrátit zpět, nebo odešle e-mail z vaší adresy, což nelze vrátit zpět.
Nástroj: folder_list
Co dělá: Vypíše vaše složky s počtem nepřečtených a celkovým počtem
Přístup: Čtení
Nástroj: email_list
Co dělá: Vypíše e-maily ve složce, nejnovější jako první
Přístup: Čtení
Nástroj: email_search
Co dělá: Vyhledává e-maily podle textu, nepřečtených, oblíbených nebo vysoké priority
Přístup: Čtení
Nástroj: email_read
Co dělá: Přečte jeden e-mail a označí jej jako přečtený
Přístup: Zápis
Nástroj: email_mark_read
Co dělá: Označí e-mail jako přečtený nebo nepřečtený
Přístup: Zápis
Nástroj: email_mark_favorite
Co dělá: Označí e-mail jako oblíbený nebo označení odstraní
Přístup: Zápis
Nástroj: email_move
Co dělá: Přesune e-mail do jiné složky
Přístup: Zápis
Nástroj: email_delete
Co dělá: Přesune e-mail do Koše
Přístup: Zápis
Nástroj: email_send
Co dělá: Odešle nový e-mail
Přístup: Zápis
Nástroj: email_reply
Co dělá: Odpoví na e-mail nebo odpoví všem
Přístup: Zápis
Nástroj: email_forward
Co dělá: Přepošle e-mail, ve výchozím nastavení s jeho přílohami
Přístup: Zápis
Každý e-mail v seznamu nebo výsledku vyhledávání obsahuje folderFullName a uid. Ostatní nástroje berou tyto dvě hodnoty jako folder a uid. uid je platné pouze v rámci své složky a při přesunu e-mailu se mění, takže po přesunu asistent použije nové uid vrácené přesunem nebo znovu vypíše složku.
Složka Virtual/All zahrnuje všechny složky, včetně Koše, Spamu, Konceptů a Odeslaných. Je přijímána pouze nástroji email_list a email_search; každý výsledek stále obsahuje skutečnou složku e-mailu.
email_search s unreadOnly: true najde nepřečtené e-maily ve všech složkách.
email_read otevře ty, na které se ptáte; přečtení je označí jako přečtené.
folder_list zobrazí složky a jejich přesné názvy.
email_list vypíše e-maily ve složce.
email_move zařadí e-mail do jiné složky nebo jej email_delete přesune do Koše.
email_search nebo email_list najde e-mail.
email_read vám jej zobrazí, takže se můžete rozhodnout, co odpovědět.
email_reply odešle vaši odpověď nebo email_forward předá e-mail někomu jinému.
folder_list — Vypsat složkyPřístup: Čtení.
Vypíše složky poštovní schránky jako plochý seznam, včetně vnořených složek. Jako argument folder ostatních nástrojů použijte fullName složky.
Tento nástroj nepřijímá žádné parametry.
{"folders": [{ "fullName": "INBOX", "name": "INBOX", "parentFullName": "", "unread": 3, "total": 120, "role": "inbox" },{ "fullName": "Receipts", "name": "Receipts", "parentFullName": "", "unread": 0, "total": 14, "role": null }]}
role je inbox, sent, drafts, trash, junk nebo archive, pokud ji složka má, jinak null.
email_list — Vypsat e-mailyPřístup: Čtení.
Vypíše e-maily jedné složky, od nejnovějších, po jedné stránce.
Parametr: folder
Povinné: Ano
Typ a omezení: Řetězec, 1–1024 znaků: fullName složky nebo Virtual/All
Parametr: page
Povinné: Ne
Typ a omezení: Celé číslo ≥ 0, indexované od nuly. Výchozí hodnota je 0
Parametr: count
Povinné: Ne
Typ a omezení: Celé číslo 1–100: e-maily na stránku. Výchozí hodnota je 25
{"items": [{"folderFullName": "INBOX","uid": 4821,"from": [{ "name": "Jane Doe", "address": "jane@example.com" }],"to": [{ "name": null, "address": "you@yourdomain.com" }],"subject": "Invoice for October","date": "2026-10-14T09:12:00Z","previewText": "Hi, please find the invoice attached…","isRead": false,"isFavorite": false,"isAnswered": false,"hasAttachments": true,"importance": "Normal"}],"total": 120,"page": 0,"count": 25,"hasMore": true}
email_search — Vyhledat e-mailyPřístup: Čtení.
Vyhledává e-maily ve složce podle textu a filtrů, po jedné stránce. Bez složky vyhledává v Virtual/All.
Parametr: folder
Povinné: Ne
Typ a omezení: Řetězec, 1–1024 znaků. Výchozí hodnota je Virtual/All
Parametr: query
Povinné: Ne
Typ a omezení: Řetězec, 3–255 znaků: text k vyhledání
Parametr: unreadOnly
Povinné: Ne
Typ a omezení: Boolean: pouze nepřečtené e-maily
Parametr: favoritesOnly
Povinné: Ne
Typ a omezení: Boolean: pouze oblíbené e-maily
Parametr: highPriorityOnly
Povinné: Ne
Typ a omezení: Boolean: pouze e-maily s vysokou prioritou
Parametr: page
Povinné: Ne
Typ a omezení: Celé číslo ≥ 0, indexované od nuly. Výchozí hodnota je 0
Parametr: count
Povinné: Ne
Typ a omezení: Celé číslo 1–100: e-maily na stránku. Výchozí hodnota je 25
Výsledek má stejnou strukturu jako email_list.
email_read — Přečíst e-mailPřístup: Zápis — čtení označí e-mail jako přečtený.
Přečte jeden e-mail: hlavičky, podrobnosti o přílohách a tělo zprávy. Tělo zprávy je vyčištěná HTML verze, pokud ji e-mail obsahuje (bodyFormathtml), jinak jeho prostý text (bodyFormattext), zkrácený na 100 000 znaků (bodyTruncated). Přílohy jsou vypsány, nikoli staženy.
Parametr: folder
Povinné: Ano
Typ a omezení: Řetězec: skutečná složka e-mailu (jeho folderFullName), nikoli Virtual/All
Parametr: uid
Povinné: Ano
Typ a omezení: Kladné celé číslo: uid e-mailu v dané složce
{"message": {"folderFullName": "INBOX","uid": 4821,"messageId": "<abc123@example.com>","from": [{ "name": "Jane Doe", "address": "jane@example.com" }],"to": [{ "name": null, "address": "you@yourdomain.com" }],"cc": [],"subject": "Invoice for October","date": "2026-10-14T09:12:00Z","body": "<p>Hi, please find the invoice attached.</p>","bodyFormat": "html","bodyTruncated": false,"attachments": [{ "name": "invoice.pdf", "contentType": "application/pdf", "size": 48213 }],"importance": "Normal"},"markedRead": true}
markedRead je false, když byl e-mail vrácen, ale jeho označení jako přečteného selhalo.
email_mark_read — Označit e-mail jako přečtený nebo nepřečtenýPřístup: Zápis.
Parametr: folder
Povinné: Ano
Typ a omezení: Řetězec: skutečná složka e-mailu, nikoli Virtual/All
Parametr: uid
Povinné: Ano
Typ a omezení: Kladné celé číslo
Parametr: read
Povinné: Ano
Typ a omezení: Boolean: true označí e-mail jako přečtený, false jako nepřečtený
{ "folderFullName": "INBOX", "uid": 4821, "isRead": true }
Nastavení stejného stavu dvakrát je neškodné. uid, které není ve složce, se nehlásí jako chyba, takže asistent bere uid z aktuálního seznamu.
email_mark_favorite — Označit e-mail jako oblíbenýPřístup: Zápis.
Parametr: folder
Povinné: Ano
Typ a omezení: Řetězec: skutečná složka e-mailu, nikoli Virtual/All
Parametr: uid
Povinné: Ano
Typ a omezení: Kladné celé číslo
Parametr: favorite
Povinné: Ano
Typ a omezení: Boolean: true označí e-mail jako oblíbený, false odstraní označení
{ "folderFullName": "INBOX", "uid": 4821, "isFavorite": true }
email_move — Přesunout e-mailPřístup: Zápis.
Přesune jeden e-mail do jiné složky stejné schránky. Přesun do složky, ve které už je, je odmítnut.
Parametr: folder
Povinné: Ano
Typ a omezení: Řetězec: skutečná složka e-mailu, nikoli Virtual/All
Parametr: uid
Povinné: Ano
Typ a omezení: Kladné celé číslo
Parametr: destinationFolder
Povinné: Ano
Typ a omezení: Řetězec: složka, do které se má e-mail přesunout, nikoli Virtual/All
{ "previousFolderFullName": "INBOX", "folderFullName": "Receipts", "uid": 77 }
E-mail dostane ve cílové složce nové uid. uid je null, když jej server neoznámil; pro nalezení e-mailu vypište cílovou složku. Přesun se nikdy automaticky neopakuje: pokud jej nebylo možné potvrdit, asistent před dalším pokusem vypíše složky.
email_delete — Smazat e-mailPřístup: Zápis.
Přesune jeden e-mail do složky Koš. E-mail se nesmaže a lze jej přesunout zpět; e-mail, který už je v Koši, je odmítnut, protože jediným zbývajícím krokem by bylo trvalé smazání, které Spacemail MCP nikdy neprovádí.
Parametr: folder
Povinné: Ano
Typ a omezení: Řetězec: skutečná složka e-mailu, nikoli Virtual/All
Parametr: uid
Povinné: Ano
Typ a omezení: Kladné celé číslo
{ "previousFolderFullName": "INBOX", "folderFullName": "Trash", "uid": 912 }
Tyto nástroje odesílají skutečné e-maily z vaší vlastní adresy Spacemail; odesílatele nelze změnit. Výsledek pouze říká, že poštovní server přijal e-mail k doručení, ne že byl doručen.
Všechny tři sdílejí tato omezení:
Příjemci jsou samotné e-mailové adresy, například alice@example.com, bez zobrazovaných jmen, celkem nejvýše 50. Stejná adresa zadaná dvakrát se počítá jen jednou.
Text (body) je prostý text o maximálně 200 000 znacích. Zalomení řádků se zachovávají; neodesílá se jako HTML.
Nelze nahrávat přílohy, neukládá se koncept a neodesílá se zabezpečená zpráva.
Odeslání se nikdy slepě neopakuje. Pokud jej poštovní server nepotvrdil (infrastructure.mailcore.outcome-unknown), e-mail mohl být přesto odeslán: asistent jej před opětovným odesláním hledá ve složce Odeslané.
email_send — Odeslat e-mailPřístup: Zápis — odešle skutečný e-mail, což nelze vrátit zpět.
Odešle nový e-mail.
Parametr: to
Povinné: Ano
Typ a omezení: Seznam 1–50 e-mailových adres
Parametr: cc
Povinné: Ne
Typ a omezení: Seznam až 50 e-mailových adres. Výchozí hodnota je žádná
Parametr: bcc
Povinné: Ne
Typ a omezení: Seznam až 50 e-mailových adres, skrytých před ostatními příjemci. Výchozí hodnota je žádná
Parametr: subject
Povinné: Ano
Typ a omezení: Řetězec: jeden řádek o maximálně 998 znacích
Parametr: body
Povinné: Ano
Typ a omezení: Řetězec: prostý text, maximálně 200 000 znaků
{ "accepted": true }
Pole To, Cc a Bcc dohromady mohou obsahovat nejvýše 50 adres.
email_reply — Odpovědět na e-mailPřístup: Zápis — odešle skutečný e-mail, což nelze vrátit zpět.
Odpoví na jeden e-mail. Předmět dostane předponu Re: (nikdy ne dvakrát), odpověď se zařadí do vlákna pod daný e-mail a e-mail bude citován pod vaším textem s hlavičkou uvádějící jeho odesílatele. Velmi dlouhý e-mail je citován do 100 000 znaků a označen jako zkrácený. Odpověď neoznačí e-mail jako přečtený.
Parametr: folder
Povinné: Ano
Typ a omezení: Řetězec: skutečná složka e-mailu, nikoli Virtual/All
Parametr: uid
Povinné: Ano
Typ a omezení: Kladné celé číslo
Parametr: body
Povinné: Ano
Typ a omezení: Řetězec: prostý text, maximálně 200 000 znaků
Parametr: replyAll
Povinné: Ne
Typ a omezení: Boolean: true odpoví také ostatním příjemcům v To a Cc. Výchozí hodnota je false
{ "accepted": true }
Odpověď jde na adresu Reply-To e-mailu; pokud žádná není nebo uvádí jen vás, pak jeho odesílateli; pokud jste to také vy, jako u e-mailu ve složce Odeslané, pak jeho původním příjemcům v To. Vaše vlastní adresa je vždy vynechána. S replyAll se přidají ostatní příjemci e-mailu v To a Cc; vaše hlavní adresa je vynechána, ale vaše aliasy ne, takže se k vám kopie může dostat přes některý z nich. Odpověď jde nejvýše 50 příjemcům.
email_forward — Přeposlat e-mailPřístup: Zápis — odešle skutečný e-mail, což nelze vrátit zpět.
Přepošle jeden e-mail novým příjemcům. Předmět dostane předponu Fwd: (nikdy ne dvakrát) a e-mail bude citován pod vaším textem s hlavičkou uvádějící jeho odesílatele, až do 100 000 znaků. Přeposlání zahájí novou konverzaci. Přeposlání neoznačí e-mail jako přečtený.
Parametr: folder
Povinné: Ano
Typ a omezení: Řetězec: skutečná složka e-mailu, nikoli Virtual/All
Parametr: uid
Povinné: Ano
Typ a omezení: Kladné celé číslo
Parametr: to
Povinné: Ano
Typ a omezení: Seznam 1–50 e-mailových adres
Parametr: body
Povinné: Ano
Typ a omezení: Řetězec: prostý text, maximálně 200 000 znaků
Parametr: includeAttachments
Povinné: Ne
Typ a omezení: Boolean: true přepošle přílohy e-mailu, false pouze jeho text. Výchozí hodnota je true
{ "accepted": true }
Když nástroj selže, asistent obdrží chybu s code, větou detail a retryable, které říká, zda může pomoci pozdější opakování. Chyby, které můžete vidět:
Kód: business.email.same-folder
Význam: Cíl je složka, ve které se e-mail již nachází
Kód: business.email.already-in-trash
Význam: E-mail je již v Koši
Kód: business.email.trash-folder-not-found
Význam: Poštovní schránka nemá žádnou složku označenou jako Koš
Kód: business.email.no-recipient
Význam: Nový e-mail nebo přeposlaný e-mail nemá příjemce
Kód: business.email.no-reply-recipient
Význam: E-mail neuvádí nikoho, komu odpovědět, kromě vás
Kód: business.email.too-many-recipients
Význam: Celkem více než 50 příjemců
Kód: business.email.unauthorized
Význam: Poštovní schránka odmítla přístup; znovu připojte Spacemail MCP
Kód: business.mailcore.folder-not-found
Význam: Složka neexistuje; zkontrolujte folder_list
Kód: business.mailcore.message-not-found
Význam: E-mail v této složce není; znovu vypište složku
Kód: business.mailcore.quota-exceeded
Význam: Poštovní schránka je plná
Kód: business.mailcore.invalid-target-folder
Význam: E-maily nelze přesunout do této složky, například Koncepty nebo Odeslané
Kód: infrastructure.mailcore.timeout
Význam: Poštovní schránka neodpověděla včas; lze opakovat
Kód: infrastructure.mailcore.unavailable
Význam: Služba poštovní schránky není dostupná; lze opakovat
Kód: infrastructure.mailcore.outcome-unknown
Význam: Přesun nebo odeslání nebylo potvrzeno; před opakováním vypište složky nebo se podívejte do Odeslaných