Spacemail MCP verbindt je AI-assistent (zoals Claude) met je Spacemail-mailbox. Daarmee kan de assistent je mappen weergeven, je e-mails weergeven, doorzoeken en lezen, ze als gelezen of als favoriet markeren, ze tussen mappen of naar Prullenbak verplaatsen, en e-mails verzenden, beantwoorden en doorsturen vanaf je eigen adres — jij vraagt het in gewone taal, en de assistent roept de juiste tools aan.
Je hebt een Spacemail-mailbox nodig. Spacemail MCP is beschikbaar op https://mcp.spacemail.com/mcp.
Hoe je verbinding maakt, hangt af van je AI-assistent:
Claude (web en desktop) — open Instellingen, kies Connectors, voeg een aangepaste connector toe en wijs deze naar https://mcp.spacemail.com/mcp. Anthropic's Claude is de client waarvan we hebben bevestigd dat Spacemail MCP ermee werkt.
Andere MCP-clients — voeg een externe MCP-server toe en wijs deze naar https://mcp.spacemail.com/mcp. Andere clients werken mogelijk, maar we hebben ze nog niet geverifieerd.
Wanneer je verbinding maakt, wordt je gevraagd je aan te melden en de assistent toegang tot je mailbox te geven. De assistent handelt dan alleen op die mailbox en alleen via de onderstaande tools.
E-mailinhoud is niet vertrouwd. Onderwerpen, afzenders, previews en berichtteksten zijn geschreven door andere mensen. Spacemail MCP vertelt de assistent om deze als gegevens te behandelen, niet als instructies, maar een e-mail kan nog steeds proberen te sturen: controleer wat de assistent voorstelt voordat je een wijziging goedkeurt.
Verzonden e-mail is echte e-mail.email_send, email_reply en email_forward verzenden vanaf je eigen Spacemail-adres, en een verzonden e-mail kan niet worden teruggehaald. De assistent mag alleen verzenden wat je hebt gevraagd: controleer de ontvangers en de tekst voordat je een verzending goedkeurt.
Alleen platte tekst. Je schrijft de tekst van een nieuwe e-mail, antwoord of doorsturing als platte tekst. Je kunt geen bijlagen uploaden, concepten opslaan of beveiligde berichten verzenden; een doorsturing kan de bijlagen bevatten van de e-mail die wordt doorgestuurd.
Niets wordt permanent verwijderd. Als je een e-mail verwijdert, wordt die naar je map Prullenbak verplaatst, vanwaar je hem terug kunt verplaatsen. Geen enkele tool leegt de Prullenbak of wist een bericht.
De overeenkomsten en beleidsregels die van toepassing zijn op Spacemail MCP:
Toegang:Lezen haalt alleen informatie op. Schrijven wijzigt je mailbox op een manier die je kunt terugdraaien, of verzendt een e-mail vanaf je adres, wat niet ongedaan kan worden gemaakt.
Tool: folder_list
Wat het doet: Je mappen weergeven met hun aantallen ongelezen en totale berichten
Toegang: Lezen
Tool: email_list
Wat het doet: De e-mails in een map weergeven, nieuwste eerst
Toegang: Lezen
Tool: email_search
Wat het doet: Zoekt e-mails op tekst, ongelezen, favoriet of hoge prioriteit
Toegang: Lezen
Tool: email_read
Wat het doet: Leest één e-mail en markeert deze als gelezen
Toegang: Schrijven
Tool: email_mark_read
Wat het doet: Markeert een e-mail als gelezen of ongelezen
Toegang: Schrijven
Tool: email_mark_favorite
Wat het doet: Markeert een e-mail als favoriet of verwijdert de markering
Toegang: Schrijven
Tool: email_move
Wat het doet: Verplaatst een e-mail naar een andere map
Toegang: Schrijven
Tool: email_delete
Wat het doet: Verplaatst een e-mail naar Prullenbak
Toegang: Schrijven
Tool: email_send
Wat het doet: Verstuurt een nieuwe e-mail
Toegang: Schrijven
Tool: email_reply
Wat het doet: Beantwoordt een e-mail of antwoordt aan iedereen
Toegang: Schrijven
Tool: email_forward
Wat het doet: Stuurt een e-mail door, standaard met de bijlagen
Toegang: Schrijven
Elke e-mail in een lijst of zoekresultaat bevat folderFullName en uid. De andere tools gebruiken deze twee waarden als folder en uid. Een uid is alleen geldig binnen de map en verandert wanneer de e-mail wordt verplaatst, dus na een verplaatsing gebruikt de assistent de nieuwe uid die door de verplaatsing is teruggegeven, of toont de map opnieuw.
De map Virtual/All omvat elke map, inclusief Prullenbak, Spam, Concepten en Verzonden. Deze wordt alleen geaccepteerd door email_list en email_search; elk resultaat bevat nog steeds de echte map van de e-mail.
email_search met unreadOnly: true vindt de ongelezen e-mails in alle mappen.
email_read opent de berichten waar je naar vraagt; door ze te lezen worden ze als gelezen gemarkeerd.
folder_list toont de mappen en hun exacte namen.
email_list toont de e-mails in de map.
email_move archiveert een e-mail in een andere map, of email_delete verplaatst deze naar Prullenbak.
email_search of email_list vindt de e-mail.
email_read toont deze aan je, zodat je kunt beslissen wat je wilt antwoorden.
email_reply verstuurt je antwoord, of email_forward stuurt de e-mail door naar iemand anders.
folder_list — Mappen tonenToegang: Lezen.
Toont de mappen van de mailbox als een platte lijst, inclusief geneste mappen. Gebruik de fullName van een map als het argument folder voor de andere tools.
Deze tool heeft geen parameters.
{"folders": [{ "fullName": "INBOX", "name": "INBOX", "parentFullName": "", "unread": 3, "total": 120, "role": "inbox" },{ "fullName": "Receipts", "name": "Receipts", "parentFullName": "", "unread": 0, "total": 14, "role": null }]}
role is inbox, sent, drafts, trash, junk of archive wanneer de map er een heeft, anders null.
email_list — E-mails tonenToegang: Lezen.
Toont de e-mails van één map, nieuwste eerst, één pagina tegelijk.
Parameter: folder
Vereist: Ja
Type & beperkingen: String, 1–1024 tekens: de fullName van de map, of Virtual/All
Parameter: page
Vereist: Nee
Type & beperkingen: Integer ≥ 0, nulgebaseerd. Standaard is 0
Parameter: count
Vereist: Nee
Type & beperkingen: Integer 1–100: e-mails per pagina. Standaard is 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 — E-mails zoekenToegang: Lezen.
Zoekt de e-mails van een map op tekst en filters, één pagina tegelijk. Zonder map wordt gezocht in Virtual/All.
Parameter: folder
Vereist: Nee
Type & beperkingen: String, 1–1024 tekens. Standaard is Virtual/All
Parameter: query
Vereist: Nee
Type & beperkingen: String, 3–255 tekens: tekst om naar te zoeken
Parameter: unreadOnly
Vereist: Nee
Type & beperkingen: Boolean: alleen ongelezen e-mails
Parameter: favoritesOnly
Vereist: Nee
Type & beperkingen: Boolean: alleen favoriete e-mails
Parameter: highPriorityOnly
Vereist: Nee
Type & beperkingen: Boolean: alleen e-mails met hoge prioriteit
Parameter: page
Vereist: Nee
Type & beperkingen: Geheel getal ≥ 0, nulgebaseerd. Standaard 0
Parameter: count
Vereist: Nee
Type & beperkingen: Geheel getal 1–100: e-mails per pagina. Standaard 25
Het resultaat heeft dezelfde vorm als email_list.
email_read — E-mail lezenToegang: Schrijven — lezen markeert de e-mail als gelezen.
Leest één e-mail: headers, details van bijlagen en de hoofdtekst. De hoofdtekst is de opgeschoonde HTML-versie wanneer de e-mail die heeft (bodyFormathtml), anders de platte tekst ervan (bodyFormattext), afgekapt op 100.000 tekens (bodyTruncated). Bijlagen worden weergegeven, niet gedownload.
Parameter: folder
Vereist: Ja
Type & beperkingen: String: de echte map van de e-mail (de folderFullName ervan), niet Virtual/All
Parameter: uid
Vereist: Ja
Type & beperkingen: Positief geheel getal: de uid van de e-mail in die map
{"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 is false wanneer de e-mail wel werd teruggegeven maar het markeren als gelezen mislukte.
email_mark_read — E-mail als gelezen of ongelezen markerenToegang: Schrijven.
Parameter: folder
Vereist: Ja
Type & beperkingen: String: de echte map van de e-mail, niet Virtual/All
Parameter: uid
Vereist: Ja
Type & beperkingen: Positief geheel getal
Parameter: read
Vereist: Ja
Type & beperkingen: Boolean: true markeert de e-mail als gelezen, false als ongelezen
{ "folderFullName": "INBOX", "uid": 4821, "isRead": true }
Dezelfde status twee keer instellen is onschadelijk. Een uid die niet in de map staat, wordt niet als fout gemeld, dus de assistent neemt uids uit een verse lijst.
email_mark_favorite — E-mail als favoriet markerenToegang: Schrijven.
Parameter: folder
Vereist: Ja
Type & beperkingen: String: de echte map van de e-mail, niet Virtual/All
Parameter: uid
Vereist: Ja
Type & beperkingen: Positief geheel getal
Parameter: favorite
Vereist: Ja
Type & beperkingen: Boolean: true markeert de e-mail als favoriet, false verwijdert de markering
{ "folderFullName": "INBOX", "uid": 4821, "isFavorite": true }
email_move — E-mail verplaatsenToegang: Schrijven.
Verplaatst één e-mail naar een andere map van dezelfde mailbox. Verplaatsen naar de map waarin die al staat, wordt geweigerd.
Parameter: folder
Vereist: Ja
Type & beperkingen: String: de echte map van de e-mail, niet Virtual/All
Parameter: uid
Vereist: Ja
Type & beperkingen: Positief geheel getal
Parameter: destinationFolder
Vereist: Ja
Type & beperkingen: String: de map waarnaar de e-mail moet worden verplaatst, niet Virtual/All
{ "previousFolderFullName": "INBOX", "folderFullName": "Receipts", "uid": 77 }
De e-mail krijgt een nieuwe uid in de doelmap. uid is null wanneer de server die niet heeft gemeld; geef de doelmap weer om de e-mail te vinden. Een verplaatsing wordt nooit automatisch opnieuw geprobeerd: als die niet kon worden bevestigd, geeft de assistent eerst de mappen weer voordat opnieuw wordt geprobeerd.
email_delete — E-mail verwijderenToegang: Schrijven.
Verplaatst één e-mail naar de map Prullenbak. De e-mail wordt niet gewist en kan worden terugverplaatst; een e-mail die al in Prullenbak staat, wordt geweigerd, omdat de enige resterende stap een permanente verwijdering zou zijn, en dat doet Spacemail MCP nooit.
Parameter: folder
Vereist: Ja
Type & beperkingen: String: de echte map van de e-mail, niet Virtual/All
Parameter: uid
Vereist: Ja
Type & beperkingen: Positief geheel getal
{ "previousFolderFullName": "INBOX", "folderFullName": "Trash", "uid": 912 }
Deze tools verzenden echte e-mail vanaf je eigen Spacemail-adres; de afzender kan niet worden gewijzigd. Het resultaat zegt alleen dat de mailserver de e-mail voor bezorging heeft geaccepteerd, niet dat die is bezorgd.
Deze drie delen dezelfde limieten:
Ontvangers zijn kale e-mailadressen zoals alice@example.com, zonder weergavenamen, in totaal maximaal 50. Hetzelfde adres dat twee keer wordt opgegeven, telt één keer.
De tekst (body) is platte tekst van maximaal 200.000 tekens. Regeleinden blijven behouden; het wordt niet als HTML verzonden.
Er kunnen geen bijlagen worden geüpload, er wordt geen concept opgeslagen en er wordt geen beveiligd bericht verzonden.
Een verzending wordt nooit blind herhaald. Als de mailserver die niet heeft bevestigd (infrastructure.mailcore.outcome-unknown), kan de e-mail toch zijn verzonden: de assistent zoekt ernaar in je map Verzonden voordat die opnieuw wordt verzonden.
email_send — E-mail verzendenToegang: Schrijven — verzendt een echte e-mail, wat niet ongedaan kan worden gemaakt.
Verzendt een nieuwe e-mail.
Parameter: to
Vereist: Ja
Type & beperkingen: Lijst van 1–50 e-mailadressen
Parameter: cc
Vereist: Nee
Type & beperkingen: Lijst van maximaal 50 e-mailadressen. Standaard geen
Parameter: bcc
Vereist: Nee
Type & beperkingen: Lijst van maximaal 50 e-mailadressen, verborgen voor de andere ontvangers. Standaard geen
Parameter: subject
Vereist: Ja
Type & beperkingen: String: één enkele regel van maximaal 998 tekens
Parameter: body
Vereist: Ja
Type & beperkingen: String: platte tekst, maximaal 200.000 tekens
{ "accepted": true }
To, Cc en Bcc samen bevatten maximaal 50 adressen.
email_reply — E-mail beantwoordenToegang: Schrijven — verzendt een echte e-mail, wat niet ongedaan kan worden gemaakt.
Beantwoordt één e-mail. Het onderwerp krijgt een voorvoegsel Re: (nooit twee keer), het antwoord wordt onder de e-mail in dezelfde thread geplaatst, en de e-mail wordt onder je tekst geciteerd met een header die de afzender noemt. Een zeer lange e-mail wordt geciteerd tot 100.000 tekens en gemarkeerd als afgekapt. Beantwoorden markeert de e-mail niet als gelezen.
Parameter: folder
Vereist: Ja
Type & beperkingen: String: de echte map van de e-mail, niet Virtual/All
Parameter: uid
Vereist: Ja
Type & beperkingen: Positief geheel getal
Parameter: body
Vereist: Ja
Type & beperkingen: String: platte tekst, maximaal 200.000 tekens
Parameter: replyAll
Vereist: Nee
Type & beperkingen: Boolean: true antwoordt ook naar de andere To- en Cc-ontvangers. Standaard false
{ "accepted": true }
Het antwoord gaat naar het Reply-To-adres van de e-mail; als dat er niet is, of als daar alleen jij wordt genoemd, naar de afzender; als dat ook jij bent, zoals bij een e-mail in je map Verzonden, naar de oorspronkelijke To-ontvangers. Je eigen adres wordt altijd weggelaten. Met replyAll worden de andere To- en Cc-ontvangers van de e-mail toegevoegd; je hoofdadres wordt weggelaten, maar je aliassen niet, dus een kopie kan je via een van die aliassen bereiken. Het antwoord gaat naar maximaal 50 ontvangers.
email_forward — E-mail doorsturenToegang: Schrijven — verzendt een echte e-mail, wat niet ongedaan kan worden gemaakt.
Stuurt één e-mail door naar nieuwe ontvangers. Het onderwerp krijgt een voorvoegsel Fwd: (nooit twee keer), en de e-mail wordt onder je tekst geciteerd met een header die de afzender noemt, tot 100.000 tekens. Een doorsturing start een nieuw gesprek. Doorsturen markeert de e-mail niet als gelezen.
Parameter: folder
Vereist: Ja
Type & beperkingen: String: de echte map van de e-mail, niet Virtual/All
Parameter: uid
Vereist: Ja
Type & beperkingen: Positief geheel getal
Parameter: to
Vereist: Ja
Type & beperkingen: Lijst van 1–50 e-mailadressen
Parameter: body
Vereist: Ja
Type & beperkingen: String: platte tekst, maximaal 200.000 tekens
Parameter: includeAttachments
Vereist: Nee
Type & beperkingen: Boolean: true stuurt de bijlagen van de e-mail door, false alleen de tekst. Standaard is dit true
{ "accepted": true }
Wanneer een tool mislukt, ontvangt de assistent een fout met een code, een detail-zin en retryable, die aangeeft of later opnieuw proberen kan helpen. De fouten die je kunt zien:
Code: business.email.same-folder
Betekenis: De bestemming is de map waarin de e-mail zich al bevindt
Code: business.email.already-in-trash
Betekenis: De e-mail staat al in Prullenbak
Code: business.email.trash-folder-not-found
Betekenis: De mailbox heeft geen map die als Prullenbak is gemarkeerd
Code: business.email.no-recipient
Betekenis: Een nieuwe e-mail of doorgestuurde e-mail heeft geen ontvanger
Code: business.email.no-reply-recipient
Betekenis: De e-mail noemt niemand om op te antwoorden behalve jou
Code: business.email.too-many-recipients
Betekenis: Meer dan 50 ontvangers in totaal
Code: business.email.unauthorized
Betekenis: De mailbox weigerde toegang; verbind Spacemail MCP opnieuw
Code: business.mailcore.folder-not-found
Betekenis: De map bestaat niet; controleer folder_list
Code: business.mailcore.message-not-found
Betekenis: De e-mail staat niet in die map; toon de map opnieuw
Code: business.mailcore.quota-exceeded
Betekenis: De mailbox is vol
Code: business.mailcore.invalid-target-folder
Betekenis: E-mails kunnen niet naar die map worden verplaatst, zoals Concepten of Verzonden
Code: infrastructure.mailcore.timeout
Betekenis: De mailbox antwoordde niet op tijd; opnieuw proberen mogelijk
Code: infrastructure.mailcore.unavailable
Betekenis: De mailboxservice is niet beschikbaar; opnieuw proberen mogelijk
Code: infrastructure.mailcore.outcome-unknown
Betekenis: Een verplaatsing of verzending is niet bevestigd; toon de mappen of kijk in Verzonden voordat je dit herhaalt