Server data from the Official MCP Registry
MCP server for Aruba email and calendar via IMAP/SMTP/CalDAV
MCP server for Aruba email and calendar via IMAP/SMTP/CalDAV
Valid MCP server (1 strong, 1 medium validity signals). 1 known CVE in dependencies Package registry verified. Imported from the Official MCP Registry.
5 files analyzed · 2 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Set these up before or after installing:
Environment variable: EMAIL_USER
Environment variable: EMAIL_PASSWORD
Environment variable: IMAP_HOST
Environment variable: SMTP_HOST
Environment variable: CALDAV_URL
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-jackfioru92-aruba-email": {
"env": {
"IMAP_HOST": "your-imap-host-here",
"SMTP_HOST": "your-smtp-host-here",
"CALDAV_URL": "your-caldav-url-here",
"EMAIL_USER": "your-email-user-here",
"EMAIL_PASSWORD": "your-email-password-here"
},
"args": [
"mcp-aruba"
],
"command": "uvx"
}
}
}From the project's GitHub README.
Italiano | English
Server MCP (Model Context Protocol) per accedere a email e calendario Aruba tramite IMAP/SMTP/CalDAV. Integra facilmente email e calendario Aruba con assistenti AI come Claude!
Per usare con GitHub Copilot in VS Code:
⌘+Shift+P → "Aruba Email: Configure Credentials"📖 Guida completa estensione VS Code
Per usare con @mcp aruba in VS Code o altri client MCP:
@mcp aruba e segui le istruzionismithery install io.github.jackfioru92/aruba-emailPer usare con Claude Desktop:
.env.example in .env:cp .env.example .env
.env con le tue credenziali Aruba:# Configurazione Email
IMAP_HOST=imaps.aruba.it
IMAP_PORT=993
IMAP_USERNAME=tua_email@aruba.it
IMAP_PASSWORD=tua_password
SMTP_HOST=smtps.aruba.it
SMTP_PORT=465
# Configurazione Calendario
CALDAV_URL=https://syncdav.aruba.it/calendars/tua_email@aruba.it/
CALDAV_USERNAME=tua_email@aruba.it
CALDAV_PASSWORD=tua_password
(Opzionale) Configura la tua firma email personalizzata:
Metodo 1: Script Interattivo (Consigliato)
# Esegui lo script interattivo
python setup_signature.py
Lo script ti guiderà nella creazione di una firma professionale con:
Metodo 2: Tramite Claude (Ancora più semplice!)
Dopo aver configurato Claude Desktop, chiedi direttamente:
"Crea una firma email per me con nome Mario Rossi,
ruolo Software Developer, azienda TechCorp e colore #0066cc"
"Configura la mia firma con questa foto: /path/to/photo.jpg"
"Imposta una firma minimal con solo nome e email"
Claude userà automaticamente i tool MCP per creare la tua firma!
La firma verrà inclusa automaticamente in tutte le email inviate.
Nota: Le credenziali sono memorizzate localmente e non lasciano mai il tuo computer. Il server MCP viene eseguito localmente e si connette direttamente ai server Aruba.
Il modo più veloce per iniziare:
# Installa dipendenze
pip install -e .
# Configura credenziali (copia e modifica .env.example)
cp .env.example .env
# Modifica .env con le tue credenziali Aruba
# Mostra le ultime email
python cli.py emails 5
# Oppure usa lo script demo
python demo_list_emails.py
Vuoi usare Claude? Dopo la configurazione, chiedi semplicemente:
Mostrami le ultime 5 email
Dammi le email più recenti
Quali email ho ricevuto oggi?
📖 Guida completa: Vedi GUIDA_UTILIZZO_EMAIL.md per tutti i metodi disponibili.
python -m mcp_aruba.server
Vedi CLAUDE_SETUP.md per istruzioni dettagliate.
Configurazione rapida per ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"aruba-email-calendar": {
"command": "python",
"args": ["-m", "mcp_aruba.server"],
"env": {
"IMAP_HOST": "imaps.aruba.it",
"IMAP_PORT": "993",
"IMAP_USERNAME": "tua_email@aruba.it",
"IMAP_PASSWORD": "tua_password",
"SMTP_HOST": "smtps.aruba.it",
"SMTP_PORT": "465",
"CALDAV_URL": "https://syncdav.aruba.it/calendars/tua_email@aruba.it/",
"CALDAV_USERNAME": "tua_email@aruba.it",
"CALDAV_PASSWORD": "tua_password"
}
}
}
}
Vedi VSCODE_SETUP.md per istruzioni dettagliate sull'uso di questo server con l'estensione Copilot MCP di VS Code.
# Attiva ambiente virtuale
source .venv/bin/activate
# Mostra ultime 5 email
python cli.py emails
# Mostra ultime 10 email
python cli.py emails 10
# Mostra eventi prossimi 7 giorni
python cli.py calendar
# Mostra eventi prossimi 14 giorni
python cli.py calendar 14
list_emailsElenca email recenti con filtri opzionali.
Parametri:
folder (str, default: "INBOX") - Cartella email da leggeresender_filter (str, opzionale) - Filtra per email mittentelimit (int, default: 10, max: 50) - Numero di email da restituireEsempi:
Mostra le ultime 5 email da john@example.com
Elenca email recenti nella mia inbox
Dammi le 10 email più recenti dal mio capo
read_emailLeggi il contenuto completo di un'email specifica.
Parametri:
email_id (str) - ID email da list_emailsfolder (str, default: "INBOX") - Cartella emailEsempi:
Leggi l'email 123
Mostrami il contenuto completo dell'email 456
search_emailsCerca email per oggetto o contenuto corpo.
Parametri:
query (str) - Query di ricercafolder (str, default: "INBOX") - Cartella dove cercarefrom_date (str, opzionale) - Solo email da questa data (formato: DD-MMM-YYYY)limit (int, default: 10, max: 50) - Numero massimo di risultatiEsempi:
Cerca email che parlano di "API" dalla settimana scorsa
Trova tutte le email su "fattura" da dicembre
send_emailInvia un'email via SMTP.
Parametri:
to (str) - Indirizzo email destinatariosubject (str) - Oggetto emailbody (str) - Corpo email (testo semplice)cc (str, opzionale) - Indirizzi email in CC, separati da virgolafrom_name (str, default: "Giacomo Fiorucci") - Nome visualizzato mittenteuse_signature (bool, default: True) - Include la firma email se configurataverify_recipient (bool, default: True) - Verifica che l'email destinatario esistaEsempi:
Invia un'email a colleague@example.com ringraziando per l'aggiornamento
Rispondi a john@example.com con lo stato del progetto
Invia un'email a client@example.com con CC a manager@company.com
Nota sulla firma: Se hai configurato una firma usando setup_signature.py, verrà automaticamente inclusa nelle email. Puoi disabilitarla temporaneamente con use_signature=False.
set_email_signatureConfigura una firma email personalizzata.
Parametri:
name (str) - Nome completoemail (str) - Indirizzo emailrole (str, opzionale) - Ruolo/posizionecompany (str, opzionale) - Nome aziendaphone (str, opzionale) - Numero di telefonowebsite (str, opzionale) - Sito webphoto_input (str, opzionale) - Percorso file foto o URL (upload automatico su Imgur)style (str, default: "professional") - Stile: professional, minimal, colorfulcolor (str, default: "#0066cc") - Colore principale (formato esadecimale)signature_name (str, default: "default") - Nome identificativo firmaEsempi:
Crea una firma con il mio nome, ruolo e foto del profilo
Configura una firma professionale con logo aziendale
get_email_signatureOttieni la firma email corrente.
Parametri:
signature_name (str, default: "default") - Nome firma da recuperarelist_email_signaturesElenca tutte le firme email salvate.
create_calendar_eventCrea un nuovo evento calendario.
Parametri:
summary (str) - Titolo eventostart (str) - Data/ora inizio in formato ISO (YYYY-MM-DDTHH:MM:SS)end (str) - Data/ora fine in formato ISOdescription (str, opzionale) - Descrizione eventolocation (str, opzionale) - Luogo eventoattendees (str, opzionale) - Lista email partecipanti separati da virgolaEsempi:
Crea un meeting chiamato "Riunione Team" domani alle 15 per 1 ora
Programma un "Project Review" il 10 dicembre alle 14 con john@example.com
list_calendar_eventsElenca eventi calendario in un intervallo di date.
Parametri:
start_date (str, opzionale) - Data inizio in formato ISO (default: oggi)end_date (str, opzionale) - Data fine in formato ISO (default: 30 giorni da ora)limit (int, default: 50) - Eventi massimi da restituireEsempi:
Mostrami il mio calendario per questa settimana
Quali eventi ho a dicembre?
Elenca tutti i miei meeting per i prossimi 7 giorni
accept_calendar_eventAccetta un invito calendario.
Parametri:
event_uid (str) - UID dell'eventocomment (str, opzionale) - Commento opzionaleEsempi:
Accetta l'invito al meeting "Team Standup"
Accetta l'evento abc123@aruba.it con commento "Non vedo l'ora!"
decline_calendar_eventDeclina un invito calendario.
Parametri:
event_uid (str) - UID dell'eventocomment (str, opzionale) - Commento opzionaleEsempi:
Declina l'evento abc123@aruba.it
Declina il meeting con commento "Mi dispiace, ho un conflitto"
tentative_calendar_eventRispondi "forse" a un invito calendario.
Parametri:
event_uid (str) - UID dell'eventocomment (str, opzionale) - Commento opzionaleEsempi:
Rispondi forse all'evento abc123@aruba.it
Segna come "forse" il meeting di domani
Forse partecipo al meeting di domani
delete_calendar_eventElimina un evento calendario.
Parametri:
event_uid (str) - UID dell'evento da eliminareEsempi:
Elimina l'evento abc123@aruba.it
Cancella il mio meeting delle 14
Mostrami le ultime email dai membri del mio team
Elenca email non lette da project@company.com
Cerca email che menzionano "modifiche API" dall'ultima settimana
Trova tutte le email su "fattura" dal 1° dicembre
Riassumi tutte le email che ho ricevuto oggi
Mostrami le email importanti di stamattina
Invia un'email a colleague@example.com ringraziandoli per l'aggiornamento
Rispondi a john@example.com con lo stato del progetto
Quali meeting ho questa settimana?
Crea una riunione team per domani alle 15
Accetta l'invito calendario per la review di venerdì
Declina il meeting di lunedì, sono in vacanza
Mostrami il mio programma per la prossima settimana
Con Claude Desktop o VS Code Copilot, puoi:
.env (gitignored di default).env nel controllo versione# Attiva ambiente virtuale
source .venv/bin/activate
# Esegui test connessione email
python test_connection.py
# Esegui test connessione calendario
python test_calendar.py
# Test creazione evento
python test_create_event.py
# Test invio invito calendario
python send_invite.py
# Formatta codice
black src/
# Type checking
mypy src/
# Linting
pylint src/
Per usare le funzionalità calendario, devi abilitare la sincronizzazione CalDAV in Aruba Webmail:
Una volta abilitato, potrai gestire completamente i tuoi calendari tramite il server MCP!
Se vedi "No calendar available", devi abilitare la sincronizzazione CalDAV (vedi sezione sopra).
.env siano corretteQ: È sicuro memorizzare le mie credenziali nel file .env?
A: Sì, finché il file .env non viene committato nel controllo versione. È già incluso in .gitignore. Le credenziali rimangono sul tuo computer locale.
Q: Posso usare questo con altri provider email?
A: Il server è ottimizzato per Aruba, ma puoi adattarlo per altri provider che supportano IMAP/SMTP/CalDAV modificando le configurazioni.
Q: Quanto costano i server MCP?
A: I server MCP sono gratuiti! Questo è software open-source. Hai solo bisogno di un abbonamento Claude o GitHub Copilot per usarlo con quegli AI.
Q: I miei dati vengono inviati a terze parti?
A: No! Il server gira localmente e si connette direttamente ai server Aruba. Nessun dato passa attraverso servizi terzi.
Q: Posso contribuire al progetto?
A: Assolutamente! Vedi CONTRIBUTING.md per linee guida.
I contributi sono benvenuti! Per favore:
git checkout -b feature/funzionalita-fantastica)git commit -m 'Aggiungi funzionalità fantastica')git push origin feature/funzionalita-fantastica)Vedi CONTRIBUTING.md per dettagli completi.
pip install mcp-aruba
Cerca "MCP Aruba Email" nel marketplace VS Code o installa direttamente:
code --install-extension jackfioru92.mcp-aruba-email
Il server è disponibile su MCP Registry
Se incontri problemi:
Questo progetto è rilasciato sotto licenza MIT. Vedi il file LICENSE per dettagli.
Giacomo Fiorucci - giacomo.fiorucci@emotion-team.com
⭐ Se questo progetto ti è utile, considera di dargli una stella su GitHub!
Be the first to review this server!
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
by Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
by mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally
by mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.
by Taylorwilsdon · Productivity
Control Gmail, Calendar, Docs, Sheets, Drive, and more from your AI