Aruba Email MCP Server

How to use

Start by running the MCP server locally so your AI assistants and MCP clients can talk to Aruba services. Use a Python-based server that exposes IMAP/SMTP/CalDAV access to your Aruba account. Once the server is running, you can use tools in CLIs, VS Code Copilot MCP, or Claude Desktop to list emails, read messages, search content, compose emails, manage signatures, and handle calendar events. You can also leverage AI to summarize conversations, draft replies, extract tasks from threads, and schedule meetings.

Typical quick actions you can perform after starting the server include:

How to install

Prerequisites you need installed on your computer before running the server:

# Prerequisites
python3 --version
pip --version

# Optional: create and activate a virtual environment
python -m venv .venv
source .venv/bin/activate

Install the MCP Aruba Email server package and dependencies. You can install from PyPI or set up via the repository's workflow:

# Install the package in editable mode from the project source
pip install -e .

# Alternative: install from MCP Registry or marketplace if you prefer a prebuilt distribution

Configure credentials and environment variables. Copy and customize the example environment file, then fill in your Aruba details:

cp .env.example .env
```

```env
# Configurazione Email
IMAP_HOST=imaps.aruba.it
IMAP_PORT=993
[email protected]
IMAP_PASSWORD=tua_password

SMTP_HOST=smtps.aruba.it
SMTP_PORT=465

# Configurazione Calendario
CALDAV_URL=https://syncdav.aruba.it/calendars/[email protected]/
[email protected]
CALDAV_PASSWORD=tua_password

Avvia il server MCP localmente. Il comando mostrato è quello tipicamente usato per eseguire il modulo MCP Aruba Aruba Email & Calendar server:

python -m mcp_aruba.server

Se vuoi automatizzare l’avvio tramite Claude Desktop o Copilot MCP, puoi configurare la tua integrazione per lanciare lo stesso comando Python in modo affidabile.

Additional sections

Configurazione con Claude Desktop è supportata. Una configurazione di esempio per Claude Desktop nella sezione di integrazione mostra come impostare le variabili d’ambiente per far girare il server MCP Aruba:

{
  "mcpServers": {
    "aruba-email-calendar": {
      "command": "python",
      "args": ["-m", "mcp_aruba.server"],
      "env": {
        "IMAP_HOST": "imaps.aruba.it",
        "IMAP_PORT": "993",
        "IMAP_USERNAME": "[email protected]",
        "IMAP_PASSWORD": "tua_password",
        "SMTP_HOST": "smtps.aruba.it",
        "SMTP_PORT": "465",
        "CALDAV_URL": "https://syncdav.aruba.it/calendars/[email protected]/",
        "CALDAV_USERNAME": "[email protected]",
        "CALDAV_PASSWORD": "tua_password"
      }
    }
  }
}

Questa configurazione assicura che le credenziali restino localmente sul tuo computer e che il server MCP si connetta direttamente ai server Aruba senza esporle a servizi esterni.

Security and privacy notes

- Esecuzione locale: il server gira sul tuo computer e mantiene credenziali localmente. - Crittografia SSL/TLS: IMAP/SMTP e CalDAV usano connessioni sicure. - Variabili d’ambiente: le credenziali sono memorizzate nel file .env (gitignored). - Nessun servizio esterno: le connessioni sono dirette ai server Aruba.

Troubleshooting

Se incontri problemi quando usi CalDAV o le credenziali non funzionano, verifica che le credenziali in .env siano corrette, assicurati che le porte (993 per IMAP, 465 per SMTP, 443 per CalDAV) non siano bloccate da firewall, e prova a rieseguire i test di connessione. Verifica anche che la sincronizzazione CalDAV sia abilitata nel tuo Aruba Webmail seguendo le istruzioni per attivare la sincronizzazione. Una volta abilitata, puoi gestire i calendari tramite MCP Aruba.

Tools and endpoints described

This MCP server exposes a comprehensive set of tools for working with Aruba Email and Calendar, including listing, reading, and searching emails; sending emails with signatures; and creating, listing, and managing calendar events with acceptance, declination, and tentative responses.

list_emails

List recent emails with optional filters for folder, sender, and limit.

read_email

Read the full content of a specific email by ID.

search_emails

Search emails by subject or body with optional date range and limit.

send_email

Send an email via SMTP with options for CC, from name, and signature inclusion.

set_email_signature

Create or update a personalized email signature with style and color options.

get_email_signature

Retrieve the current email signature.

list_email_signatures

List all saved email signatures.

create_calendar_event

Create a new calendar event with optional attendees.

list_calendar_events

List upcoming calendar events within a date range.

accept_calendar_event

Accept a calendar event invitation.

decline_calendar_event

Decline a calendar event invitation.

tentative_calendar_event

Respond to a calendar invitation with a tentative status.

delete_calendar_event

Delete a calendar event.