mcp-aruba-email

This MCP server exposes your Aruba email and calendar through IMAP, SMTP, and CalDAV so you can interact with messages and calendar events via MCP-enabled assistants and clients. You can list, read, and search emails using the email tools, and manage calendar events (create, list, accept/decline responses, and delete) using the calendar tools. The server is designed to work well with Claude Desktop, VS Code Copilot MCP integration, and other MCP clients, enabling seamless AI-assisted email and calendar workflows. To get started, configure your Aruba credentials (IMAP/SMTP for mail and CalDAV for calendars) in the environment, then run the MCP server and query the available tools like list_emails, read_email, search_emails, and the calendar commands to manage events. When using Claude or Copilot, you can issue natural language prompts such as “Show my latest emails,” “Create a calendar event for next Wednesday,” or “Accept calendar invites from John Doe.”

Prerequisites:

• Python 3.10+ installed on your machine
• A working Aruba email account with IMAP/SMTP and CalDAV access
• Access to install Python packages (pip)

Step-by-step installation:

1. Clone the repository (or install from your package source).

git clone https://github.com/jackfioru92/mcp-aruba-email.git
cd mcp-aruba-email

2. Create and activate a Python virtual environment (recommended).

python -m venv .venv
source .venv/bin/activate  # on macOS/Linux
.venv\Scripts\activate     # on Windows

3. Install the package in editable mode (if you have a setup.py or pyproject.toml).

pip install -e .

4. Prepare configuration by copying the example environment file and editing credentials.

cps .env.example .env  # or copy manually

Edit .env to include your Aruba credentials:

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

5. Run the MCP server:

python -m mcp_aruba.server

6. (Optional) Configure MCP in your environment or IDE using the provided mcp_servers entry as shown in the mcp_config section above.

Notes and tips:

• Always store credentials locally and avoid committing them to version control.
• Adjust CALDAV_URL, CALDAV_USERNAME, and CALDAV_PASSWORD to match your Aruba CalDAV setup if different from the defaults.
• If you encounter SSL/TLS issues with IMAP/SMTP, ensure you’re connecting to the correct ports (993 for IMAP over SSL, 465 for SMTP over SSL) and that your network allows outbound TLS connections.
• The MCP tooling is designed to work with Claude Desktop and VS Code Copilot; to use Claude, follow the Claude setup docs and point it at the aruba-email-calendar MCP server entry.
• You can customize the environment further by adding additional variables if your deployment needs advanced authentication or proxy settings.