Aruba Email & Calendar

MCP Aruba Email & Calendar Server

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!

📦 Come Installare

Opzione 1: Estensione VS Code (Più Semplice) ⭐

Per usare con GitHub Copilot in VS Code:

1. Installa l'estensione dal VS Code Marketplace
2. Configura le credenziali con ⌘+Shift+P → "Aruba Email: Configure Credentials"
3. Usa direttamente in Copilot Chat!

📖 Guida completa estensione VS Code

Opzione 2: Da Smithery (Registro MCP) 🔍

Per usare con @mcp aruba in VS Code o altri client MCP:

1. Il server è disponibile su Smithery
2. In VS Code Copilot Chat, digita @mcp aruba e segui le istruzioni
3. Oppure installa da CLI: smithery install io.github.jackfioru92/aruba-email

Opzione 3: Installazione Manuale (Per Claude Desktop)

Per usare con Claude Desktop:

Funzionalità

Email

• 📧 Elenca email - Naviga nella casella con filtri per mittente
• 🔍 Cerca email - Ricerca per oggetto/corpo con filtri data
• 📖 Leggi email - Ottieni il contenuto completo (HTML convertito in testo pulito)
• ✉️ Invia email - Invia email via SMTP con firma personalizzata
• ✍️ Firma email - Crea firme professionali con foto e colori brand
• 📎 Allegati - Lista e scarica allegati email (PDF, immagini, documenti)
• 💾 Esporta .eml - Esporta email in formato RFC822 per backup

Calendario

• 📅 Crea eventi - Crea eventi calendario con partecipanti
• 📋 Elenca eventi - Visualizza eventi futuri
• ✅ Accetta inviti - Accetta inviti calendario
• ❌ Declina inviti - Declina inviti calendario
• ❓ Forse - Rispondi "forse" agli inviti calendario
• 🗑️ Elimina eventi - Rimuovi eventi dal calendario

Generale

• 🔒 Sicuro - Usa IMAP/SMTP/CalDAV su SSL/TLS
• ⚡ Veloce - Gestione efficiente delle connessioni con context manager
• 🤖 Pronto per AI - Funziona perfettamente con Claude Desktop e altri client MCP

Configurazione (Solo per Installazione Manuale)

1. Copia .env.example in .env:

cp .env.example .env

1. Modifica .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

1. (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:

• 📝 Informazioni personali (nome, ruolo, azienda, contatti)
• 🎨 Scelta dello stile (professional, minimal, colorful)
• 🌈 Personalizzazione colori
• 📸 Upload automatico foto su Imgur (opzionale)

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.

Utilizzo

🚀 Inizio Rapido: Visualizza le Ultime Email

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.

Esegui il server direttamente

python -m mcp_aruba.server

Configura con Claude Desktop

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" } } } }

Configura con VS Code Copilot

Vedi VSCODE_SETUP.md per istruzioni dettagliate sull'uso di questo server con l'estensione Copilot MCP di VS Code.

Usa la CLI rapida

# 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

Strumenti Disponibili

Strumenti Email

list_emails

Elenca email recenti con filtri opzionali.

Parametri:

• folder (str, default: "INBOX") - Cartella email da leggere
• sender_filter (str, opzionale) - Filtra per email mittente
• limit (int, default: 10, max: 50) - Numero di email da restituire

Esempi:

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_email

Leggi il contenuto completo di un'email specifica.

Parametri:

• email_id (str) - ID email da list_emails
• folder (str, default: "INBOX") - Cartella email

Esempi:

Leggi l'email 123

Mostrami il contenuto completo dell'email 456

search_emails

Cerca email per oggetto o contenuto corpo.

Parametri:

• query (str) - Query di ricerca
• folder (str, default: "INBOX") - Cartella dove cercare
• from_date (str, opzionale) - Solo email da questa data (formato: DD-MMM-YYYY)
• limit (int, default: 10, max: 50) - Numero massimo di risultati

Esempi:

Cerca email che parlano di "API" dalla settimana scorsa

Trova tutte le email su "fattura" da dicembre

send_email

Invia un'email via SMTP.

Parametri:

• to (str) - Indirizzo email destinatario
• subject (str) - Oggetto email
• body (str) - Corpo email (testo semplice)
• cc (str, opzionale) - Indirizzi email in CC, separati da virgola
• from_name (str, default: "Giacomo Fiorucci") - Nome visualizzato mittente
• use_signature (bool, default: True) - Include la firma email se configurata
• verify_recipient (bool, default: True) - Verifica che l'email destinatario esista

Esempi:

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_signature

Configura una firma email personalizzata.

Parametri:

• name (str) - Nome completo
• email (str) - Indirizzo email
• role (str, opzionale) - Ruolo/posizione
• company (str, opzionale) - Nome azienda
• phone (str, opzionale) - Numero di telefono
• website (str, opzionale) - Sito web
• photo_input (str, opzionale) - Percorso file foto o URL (upload automatico su Imgur)
• style (str, default: "professional") - Stile: professional, minimal, colorful
• color (str, default: "#0066cc") - Colore principale (formato esadecimale)
• signature_name (str, default: "default") - Nome identificativo firma

Esempi:

Crea una firma con il mio nome, ruolo e foto del profilo

Configura una firma professionale con logo aziendale

get_email_signature

Ottieni la firma email corrente.

Parametri:

• signature_name (str, default: "default") - Nome firma da recuperare

list_email_signatures

Elenca tutte le firme email salvate.

Strumenti Calendario

create_calendar_event

Crea un nuovo evento calendario.

Parametri:

• summary (str) - Titolo evento
• start (str) - Data/ora inizio in formato ISO (YYYY-MM-DDTHH:MM:SS)
• end (str) - Data/ora fine in formato ISO
• description (str, opzionale) - Descrizione evento
• location (str, opzionale) - Luogo evento
• attendees (str, opzionale) - Lista email partecipanti separati da virgola

Esempi:

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_events

Elenca 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 restituire

Esempi:

Mostrami il mio calendario per questa settimana

Quali eventi ho a dicembre? Elenca tutti i miei meeting per i prossimi 7 giorni

accept_calendar_event

Accetta un invito calendario.

Parametri:

• event_uid (str) - UID dell'evento
• comment (str, opzionale) - Commento opzionale

Esempi:

Accetta l'invito al meeting "Team Standup"

Accetta l'evento abc123@aruba.it con commento "Non vedo l'ora!"

decline_calendar_event

Declina un invito calendario.

Parametri:

• event_uid (str) - UID dell'evento
• comment (str, opzionale) - Commento opzionale

Esempi:

Declina l'evento abc123@aruba.it

Declina il meeting con commento "Mi dispiace, ho un conflitto"

tentative_calendar_event

Rispondi "forse" a un invito calendario.

Parametri:

• event_uid (str) - UID dell'evento
• comment (str, opzionale) - Commento opzionale

Esempi:

Rispondi forse all'evento abc123@aruba.it

Segna come "forse" il meeting di domani Forse partecipo al me