Aruba Email & Calendar

Install

Config snippet generator goes here (5 client tabs)

README

# MCP Aruba Email & Calendar Server

<!-- mcp-name: io.github.jackfioru92/aruba-email -->

**Italiano** | [English](README_EN.md)

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!

[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![PyPI version](https://badge.fury.io/py/mcp-aruba.svg)](https://badge.fury.io/py/mcp-aruba)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![MCP](https://img.shields.io/badge/MCP-1.2.0+-green.svg)](https://modelcontextprotocol.io/)
[![VS Code Extension](https://img.shields.io/visual-studio-marketplace/v/jackfioru92.mcp-aruba-email)](https://marketplace.visualstudio.com/items?itemName=jackfioru92.mcp-aruba-email)
[![Downloads](https://img.shields.io/visual-studio-marketplace/d/jackfioru92.mcp-aruba-email)](https://marketplace.visualstudio.com/items?itemName=jackfioru92.mcp-aruba-email)
[![GitHub stars](https://img.shields.io/github/stars/jackfioru92/mcp-aruba-email?style=social)](https://github.com/jackfioru92/mcp-aruba-email)

## 📦 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](https://marketplace.visualstudio.com/items?itemName=jackfioru92.mcp-aruba-email)
2. Configura le credenziali con `⌘+Shift+P` → **"Aruba Email: Configure Credentials"**
3. Usa direttamente in Copilot Chat!

📖 [Guida completa estensione VS Code](docs/VSCODE_EXTENSION.md)

### Opzione 2: Da Smithery (Registro MCP) 🔍

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

1. Il server è disponibile su [Smithery](https://smithery.ai/server/io.github.jackfioru92/aruba-email)
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`

[![Smithery](https://smithery.ai/badge/io.github.jackfioru92/aruba-email)](https://smithery.ai/server/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`:
```bash
cp .env.example .env
```

2. Modifica `.env` con le tue credenziali Aruba:
```env
# 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
   # 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 conn