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

2. 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

3. (Opzionale) Configura la tua firma email personalizzata:

   Metodo 1: Script Interattivo (Consigliato)

   bash

   Copy

   # 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!)

   Code

   Copy

   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