Spacemail MCP collega il tuo assistente AI (come Claude) alla tua casella di posta Spacemail. Tramite esso, l'assistente può elencare le tue cartelle, elencare, cercare e leggere le tue email, contrassegnarle come lette o come preferite, spostarle tra le cartelle o nel Cestino e inviare, rispondere e inoltrare email dal tuo indirizzo — tu chiedi in linguaggio semplice e l'assistente richiama gli strumenti giusti.
Hai bisogno di una casella di posta Spacemail. Spacemail MCP è disponibile su https://mcp.spacemail.com/mcp.
Il modo in cui ti connetti dipende dal tuo assistente AI:
Claude (web e desktop) — apri Impostazioni, scegli Connectors, aggiungi un connettore personalizzato e indirizzalo a https://mcp.spacemail.com/mcp. Claude di Anthropic è il client con cui abbiamo verificato che Spacemail MCP funzioni.
Altri client MCP — aggiungi un server MCP remoto e indirizzalo a https://mcp.spacemail.com/mcp. Altri client potrebbero funzionare, ma non li abbiamo ancora verificati.
Quando ti connetti, ti verrà chiesto di accedere e approvare l'accesso dell'assistente alla tua casella di posta. L'assistente agirà quindi solo su quella casella di posta e solo tramite gli strumenti qui sotto.
Il contenuto delle email non è attendibile. Oggetti, mittenti, anteprime e corpi dei messaggi sono scritti da altre persone. Spacemail MCP dice all'assistente di trattarli come dati, non come istruzioni, ma un'email può comunque cercare di influenzarlo: controlla ciò che l'assistente propone prima di approvare una modifica.
Un'email inviata è un'email reale.email_send, email_reply e email_forward inviano dal tuo indirizzo Spacemail e un'email inviata non può essere richiamata. L'assistente dovrebbe inviare solo ciò che hai richiesto: controlla i destinatari e il testo prima di approvare un invio.
Solo testo semplice. Scrivi il testo di una nuova email, risposta o inoltro come testo semplice. Non puoi caricare allegati, salvare bozze o inviare messaggi sicuri; un inoltro può includere gli allegati dell'email che inoltra.
Nulla viene eliminato in modo permanente. Eliminare un'email la sposta nella cartella Cestino, da cui puoi riportarla indietro. Nessuno strumento svuota il Cestino o cancella un messaggio.
Gli accordi e le politiche che si applicano a Spacemail MCP:
Accesso:Lettura recupera solo informazioni. Scrittura modifica la tua casella di posta in un modo che puoi annullare, oppure invia un'email dal tuo indirizzo, cosa che non può essere annullata.
Strumento: folder_list
Cosa fa: Elenca le tue cartelle con il numero di email non lette e il totale
Accesso: Lettura
Strumento: email_list
Cosa fa: Elenca le email in una cartella, dalla più recente
Accesso: Lettura
Strumento: email_search
Cosa fa: Cerca email per testo, non lette, preferite o ad alta priorità
Accesso: Lettura
Strumento: email_read
Cosa fa: Legge un'email e la contrassegna come letta
Accesso: Scrittura
Strumento: email_mark_read
Cosa fa: Contrassegna un'email come letta o non letta
Accesso: Scrittura
Strumento: email_mark_favorite
Cosa fa: Contrassegna un'email come preferita o rimuove il contrassegno
Accesso: Scrittura
Strumento: email_move
Cosa fa: Sposta un'email in un'altra cartella
Accesso: Scrittura
Strumento: email_delete
Cosa fa: Sposta un'email nel Cestino
Accesso: Scrittura
Strumento: email_send
Cosa fa: Invia una nuova email
Accesso: Scrittura
Strumento: email_reply
Cosa fa: Risponde a un'email o risponde a tutti
Accesso: Scrittura
Strumento: email_forward
Cosa fa: Inoltra un'email, con i suoi allegati per impostazione predefinita
Accesso: Scrittura
Ogni email in un elenco o in un risultato di ricerca contiene folderFullName e uid. Gli altri strumenti prendono questi due valori come folder e uid. Un uid è valido solo all'interno della sua cartella e cambia quando l'email viene spostata, quindi dopo uno spostamento l'assistente usa il nuovo uid restituito dallo spostamento oppure elenca di nuovo la cartella.
La cartella Virtual/All comprende tutte le cartelle, inclusi Cestino, Spam, Bozze e Posta inviata. È accettata solo da email_list e email_search; ogni risultato riporta comunque la cartella reale dell'email.
email_search con unreadOnly: true trova le email non lette in tutte le cartelle.
email_read apre quelle di cui chiedi; la lettura le contrassegna come lette.
folder_list mostra le cartelle e i loro nomi esatti.
email_list elenca le email della cartella.
email_move archivia un'email in un'altra cartella, oppure email_delete la sposta nel Cestino.
email_search o email_list trova l'email.
email_read te la mostra, così puoi decidere cosa rispondere.
email_reply invia la tua risposta, oppure email_forward inoltra l'email a qualcun altro.
folder_list — Elenca le cartelleAccesso: Lettura.
Elenca le cartelle della casella di posta come elenco semplice, incluse le cartelle nidificate. Usa il fullName di una cartella come argomento folder degli altri strumenti.
Questo strumento non accetta parametri.
{"folders": [{ "fullName": "INBOX", "name": "INBOX", "parentFullName": "", "unread": 3, "total": 120, "role": "inbox" },{ "fullName": "Receipts", "name": "Receipts", "parentFullName": "", "unread": 0, "total": 14, "role": null }]}
role è inbox, sent, drafts, trash, junk o archive quando la cartella ne ha uno, altrimenti null.
email_list — Elenca le emailAccesso: Lettura.
Elenca le email di una cartella, dalla più recente alla meno recente, una pagina alla volta.
Parametro: folder
Obbligatorio: Sì
Tipo e vincoli: Stringa, 1–1024 caratteri: il fullName della cartella, oppure Virtual/All
Parametro: page
Obbligatorio: No
Tipo e vincoli: Intero ≥ 0, con base zero. Il valore predefinito è 0
Parametro: count
Obbligatorio: No
Tipo e vincoli: Intero 1–100: email per pagina. Il valore predefinito è 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 — Cerca emailAccesso: Lettura.
Cerca le email di una cartella per testo e filtri, una pagina alla volta. Senza una cartella, cerca in Virtual/All.
Parametro: folder
Obbligatorio: No
Tipo e vincoli: Stringa, 1–1024 caratteri. Il valore predefinito è Virtual/All
Parametro: query
Obbligatorio: No
Tipo e vincoli: Stringa, 3–255 caratteri: testo da cercare
Parametro: unreadOnly
Obbligatorio: No
Tipo e vincoli: Booleano: solo email non lette
Parametro: favoritesOnly
Obbligatorio: No
Tipo e vincoli: Booleano: solo email preferite
Parametro: highPriorityOnly
Obbligatorio: No
Tipo e vincoli: Booleano: solo email ad alta priorità
Parametro: page
Obbligatorio: No
Tipo e vincoli: Intero ≥ 0, con indice a partire da zero. Il valore predefinito è 0
Parametro: count
Obbligatorio: No
Tipo e vincoli: Intero 1–100: email per pagina. Il valore predefinito è 25
Il risultato ha la stessa struttura di email_list.
email_read — Leggi emailAccesso: Scrittura — la lettura contrassegna l'email come letta.
Legge una singola email: intestazioni, dettagli degli allegati e corpo. Il corpo è la versione HTML ripulita quando l'email ne ha una (bodyFormathtml), altrimenti il suo testo semplice (bodyFormattext), troncato a 100.000 caratteri (bodyTruncated). Gli allegati vengono elencati, non scaricati.
Parametro: folder
Obbligatorio: Sì
Tipo e vincoli: Stringa: la cartella reale dell'email (il suo folderFullName), non Virtual/All
Parametro: uid
Obbligatorio: Sì
Tipo e vincoli: Intero positivo: l'uid dell'email in quella cartella
{"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 è false quando l'email è stata restituita ma la marcatura come letta non è riuscita.
email_mark_read — Contrassegna email come letta o non lettaAccesso: Scrittura.
Parametro: folder
Obbligatorio: Sì
Tipo e vincoli: Stringa: la cartella reale dell'email, non Virtual/All
Parametro: uid
Obbligatorio: Sì
Tipo e vincoli: Intero positivo
Parametro: read
Obbligatorio: Sì
Tipo e vincoli: Booleano: true contrassegna l'email come letta, false come non letta
{ "folderFullName": "INBOX", "uid": 4821, "isRead": true }
Impostare due volte lo stesso stato è innocuo. Un uid che non si trova nella cartella non viene segnalato come errore, quindi l'assistente prende gli uid da un elenco aggiornato.
email_mark_favorite — Contrassegna email come preferitaAccesso: Scrittura.
Parametro: folder
Obbligatorio: Sì
Tipo e vincoli: Stringa: la cartella reale dell'email, non Virtual/All
Parametro: uid
Obbligatorio: Sì
Tipo e vincoli: Intero positivo
Parametro: favorite
Obbligatorio: Sì
Tipo e vincoli: Booleano: true contrassegna l'email come preferita, false rimuove il contrassegno
{ "folderFullName": "INBOX", "uid": 4821, "isFavorite": true }
email_move — Sposta emailAccesso: Scrittura.
Sposta una singola email in un'altra cartella della stessa casella di posta. Lo spostamento nella cartella in cui si trova già viene rifiutato.
Parametro: folder
Obbligatorio: Sì
Tipo e vincoli: Stringa: la cartella reale dell'email, non Virtual/All
Parametro: uid
Obbligatorio: Sì
Tipo e vincoli: Intero positivo
Parametro: destinationFolder
Obbligatorio: Sì
Tipo e vincoli: Stringa: la cartella in cui spostare l'email, non Virtual/All
{ "previousFolderFullName": "INBOX", "folderFullName": "Receipts", "uid": 77 }
L'email riceve un nuovo uid nella cartella di destinazione. uid è null quando il server non lo ha segnalato; elenca la cartella di destinazione per trovare l'email. Uno spostamento non viene mai ritentato automaticamente: se non è stato possibile confermarlo, l'assistente elenca le cartelle prima di riprovare.
email_delete — Elimina emailAccesso: Scrittura.
Sposta una singola email nella cartella Cestino. L'email non viene cancellata e può essere riportata indietro; un'email che si trova già nel Cestino viene rifiutata, perché l'unico passaggio rimanente sarebbe un'eliminazione permanente, che Spacemail MCP non esegue mai.
Parametro: folder
Obbligatorio: Sì
Tipo e vincoli: Stringa: la cartella reale dell'email, non Virtual/All
Parametro: uid
Obbligatorio: Sì
Tipo e vincoli: Intero positivo
{ "previousFolderFullName": "INBOX", "folderFullName": "Trash", "uid": 912 }
Questi strumenti inviano email reali dal tuo indirizzo Spacemail; il mittente non può essere cambiato. Il risultato dice solo che il server di posta ha accettato l'email per la consegna, non che sia stata consegnata.
Tutti e tre condividono questi limiti:
I destinatari sono semplici indirizzi email come alice@example.com, senza nomi visualizzati, al massimo 50 in totale. Lo stesso indirizzo fornito due volte conta una sola volta.
Il testo (body) è testo semplice di massimo 200.000 caratteri. Le interruzioni di riga vengono mantenute; non viene inviato come HTML.
Non è possibile caricare allegati, non viene salvata alcuna bozza e non viene inviato alcun messaggio sicuro.
Un invio non viene mai ripetuto alla cieca. Se il server di posta non lo ha confermato (infrastructure.mailcore.outcome-unknown), l'email potrebbe comunque essere stata inviata: l'assistente la cerca nella tua cartella Posta inviata prima di inviarla di nuovo.
email_send — Invia emailAccesso: Scrittura — invia un'email reale, che non può essere annullata.
Invia una nuova email.
Parametro: to
Obbligatorio: Sì
Tipo e vincoli: Elenco di 1–50 indirizzi email
Parametro: cc
Obbligatorio: No
Tipo e vincoli: Elenco di fino a 50 indirizzi email. Il valore predefinito è nessuno
Parametro: bcc
Obbligatorio: No
Tipo e vincoli: Elenco di fino a 50 indirizzi email, nascosti agli altri destinatari. Il valore predefinito è nessuno
Parametro: subject
Obbligatorio: Sì
Tipo e vincoli: Stringa: una singola riga di massimo 998 caratteri
Parametro: body
Obbligatorio: Sì
Tipo e vincoli: Stringa: testo semplice, massimo 200.000 caratteri
{ "accepted": true }
To, Cc e Bcc insieme possono contenere al massimo 50 indirizzi.
email_reply — Rispondi a emailAccesso: Scrittura — invia un'email reale, che non può essere annullata.
Risponde a una singola email. L'oggetto riceve il prefisso Re: (mai due volte), la risposta viene inserita nel thread sotto l'email e l'email viene citata sotto il tuo testo con un'intestazione che ne indica il mittente. Un'email molto lunga viene citata fino a 100.000 caratteri e contrassegnata come troncata. Rispondere non contrassegna l'email come letta.
Parametro: folder
Obbligatorio: Sì
Tipo e vincoli: Stringa: la cartella reale dell'email, non Virtual/All
Parametro: uid
Obbligatorio: Sì
Tipo e vincoli: Intero positivo
Parametro: body
Obbligatorio: Sì
Tipo e vincoli: Stringa: testo semplice, massimo 200.000 caratteri
Parametro: replyAll
Obbligatorio: No
Tipo e vincoli: Booleano: true risponde anche agli altri destinatari To e Cc. Il valore predefinito è false
{ "accepted": true }
La risposta va all'indirizzo Reply-To dell'email; quando non c'è, o indica solo te, va al suo mittente; quando anche quello sei tu, come per un'email nella tua cartella Posta inviata, va ai destinatari To originali. Il tuo indirizzo viene sempre escluso. Con replyAll, vengono aggiunti gli altri destinatari To e Cc dell'email; il tuo indirizzo principale viene escluso, ma non i tuoi alias, quindi una copia potrebbe raggiungerti tramite uno di essi. La risposta va a un massimo di 50 destinatari.
email_forward — Inoltra emailAccesso: Scrittura — invia un'email reale, che non può essere annullata.
Inoltra una singola email a nuovi destinatari. L'oggetto riceve il prefisso Fwd: (mai due volte) e l'email viene citata sotto il tuo testo con un'intestazione che ne indica il mittente, fino a 100.000 caratteri. Un inoltro avvia una nuova conversazione. Inoltrare non contrassegna l'email come letta.
Parametro: folder
Obbligatorio: Sì
Tipo e vincoli: Stringa: la cartella reale dell'email, non Virtual/All
Parametro: uid
Obbligatorio: Sì
Tipo e vincoli: Intero positivo
Parametro: to
Obbligatorio: Sì
Tipo e vincoli: Elenco di 1–50 indirizzi email
Parametro: body
Obbligatorio: Sì
Tipo e vincoli: Stringa: testo semplice, massimo 200.000 caratteri
Parametro: includeAttachments
Obbligatorio: No
Tipo e vincoli: Booleano: true inoltra gli allegati dell'email, false solo il suo testo. Il valore predefinito è true
{ "accepted": true }
Quando uno strumento non riesce, l'assistente riceve un errore con un code, una frase detail e retryable, che indica se riprovare più tardi può essere utile. Gli errori che potresti vedere:
Codice: business.email.same-folder
Significato: La destinazione è la cartella in cui si trova già l'email
Codice: business.email.already-in-trash
Significato: L'email è già nel Cestino
Codice: business.email.trash-folder-not-found
Significato: La casella di posta non ha alcuna cartella contrassegnata come Cestino
Codice: business.email.no-recipient
Significato: Una nuova email o un inoltro non ha destinatari
Codice: business.email.no-reply-recipient
Significato: L'email non indica nessuno a cui rispondere tranne te
Codice: business.email.too-many-recipients
Significato: Più di 50 destinatari in totale
Codice: business.email.unauthorized
Significato: La casella di posta ha rifiutato l'accesso; ricollega Spacemail MCP
Codice: business.mailcore.folder-not-found
Significato: La cartella non esiste; controlla folder_list
Codice: business.mailcore.message-not-found
Significato: L'email non è in quella cartella; elenca di nuovo la cartella
Codice: business.mailcore.quota-exceeded
Significato: La casella di posta è piena
Codice: business.mailcore.invalid-target-folder
Significato: Le email non possono essere spostate in quella cartella, come Bozze o Posta inviata
Codice: infrastructure.mailcore.timeout
Significato: La casella di posta non ha risposto in tempo; ripetibile
Codice: infrastructure.mailcore.unavailable
Significato: Il servizio della casella di posta non è disponibile; ripetibile
Codice: infrastructure.mailcore.outcome-unknown
Significato: Uno spostamento o un invio non è stato confermato; elenca le cartelle o controlla in Posta inviata prima di ripeterlo