Aruba Email & Calendar

List emails from the specified folder. Args: folder: Mail folder to list from (default: INBOX) sender_filter: Optional filter by sender email address (e.g., "denisa@c-tic.it") limit: Maximum number of emails to return (default: 10, max: 50) Returns: List of email summaries with id, from, to, subject, date, and body preview Example: list_emails(sender_filter="denisa@c-tic.it", limit=5)

Read the full content of a specific email. Args: email_id: Email ID to read (from list_emails) folder: Mail folder (default: INBOX) Returns: Full email content with from, to, subject, date, and body Example: read_email(email_id="123")

Search emails by subject or body content. Args: query: Search query string (searches in subject and body) folder: Mail folder to search in (default: INBOX) from_date: Only emails from this date onwards (format: DD-MMM-YYYY, e.g., "01-Dec-2024") limit: Maximum number of results (default: 10, max: 50) Returns: List of matching emails Example: search_emails(query="API", from_date="01-Dec-2024", limit=5)

Get list of attachments for a specific email. Args: email_id: Email ID (from list_emails or search_emails) folder: Mail folder (default: INBOX) Returns: List of attachments with index, filename, content_type, and size Example: get_email_attachments(email_id="123")

Download a specific attachment from an email. Args: email_id: Email ID attachment_index: Index of attachment (from get_email_attachments, starting at 0) folder: Mail folder (default: INBOX) Returns: Dictionary with filename, content_type, size, and data_base64 (base64 encoded content) Example: download_attachment(email_id="123", attachment_index=0) Note: The attachment content is returned as base64 encoded string in 'data_base64' field. You can decode it and save to file.

Download an email attachment and save it directly to disk. This is the PREFERRED tool for attachments — saves the file and returns the local path so the user can open it immediately. No base64 decoding needed. Args: email_id: Email ID attachment_index: Index of attachment (from get_email_attachments, starting at 0) folder: Mail folder (default: INBOX) save_dir: Directory to save into (default: user's Downloads folder) Returns: Dictionary with filename, saved_path, content_type, and size Example: save_attachment(email_id="123", attachment_index=0)

Get raw email content in RFC822 format for .eml export. Args: email_id: Email ID folder: Mail folder (default: INBOX) Returns: Dictionary with raw_content (RFC822 format string) Example: get_raw_email(email_id="123") Note: Save the raw_content to a .eml file to export the email.

Send a NEW email via SMTP (not a reply). For replying to an existing email thread, use reply_email() instead. Args: to: Recipient email address subject: Email subject body: Email body (plain text) cc: Optional CC email addresses (comma-separated) from_name: Sender display name (default: "" — uses email address only) attachments: Optional comma-separated file paths to attach (e.g., "/path/to/file.pdf,/path/to/image.png") Returns: Send status with details Example: send_email( to="christopher.caponi@emotion-team.com", subject="Ciao Christopher!", body="Come stai? Ti scrivo per...", attachments="/path/to/documento.pdf" )

Reply to an existing email, preserving the thread. Fetches the original email, extracts threading headers (Message-ID, References), and sends a reply that appears in the same conversation thread in the recipient's mail client. Args: email_id: Email ID to reply to (from list_emails) body: Reply body (plain text) cc: Optional CC email addresses (comma-separated) folder: Mail folder where the original email lives (default: INBOX) attachments: Optional comma-separated file paths to attach (e.g., "/path/to/file.pdf,/path/to/image.png") Returns: Send status with details Example: reply_email( email_id="123", body="Thank you for your email, here is the updated proposal.", attachments="/path/to/proposal.pdf" )

Check for bounced or failed email delivery notifications. This tool searches for delivery failure notifications (bounce-backs) that indicate emails could not be delivered. Common reasons include: - Recipient mailbox does not exist - Recipient mailbox is full - Message rejected by recipient server Args: folder: Mail folder to check (default: INBOX) limit: Maximum number of bounce notifications to check (default: 20) Returns: List of bounce notifications with failed recipient and reason Example: check_bounced_emails(limit=10)

Create and save a professional email signature with optional photo and colors. The signature will be automatically appended to all sent emails. If photo_url or color are provided, an HTML signature will be created. Args: name: Full name (e.g., "Giacomo Fiorucci") email: Email address role: Job title/role (optional, e.g., "Software Developer") company: Company name (optional, e.g., "Emotion Team") phone: Phone number (optional, e.g., "+39 123 456 7890") photo_url: URL or local file path to profile photo (optional, auto-uploads if local file) color: Hex color code for accents (optional, e.g., "#0066cc", "#FF5722") style: Signature style - "professional", "minimal", "colorful" (default: "professional") signature_name: Name to save signature as (default: "default") Returns: Confirmation with signature preview Examples: # Simple text signature set_email_signature( name="Giacomo Fiorucci", email="giacomo.fiorucci@emotion-team.com", role="Software Developer", company="Emotion Team" ) # HTML signature with photo and custom color set_email_signature( name="Giacomo Fiorucci", email="giacomo.fiorucci@emotion-team.com", role="Software Developer", company="Emotion Team", phone="+39 123 456 7890", photo_url="https://example.com/photo.jpg", color="#0066cc", style="professional" )

Get a saved email signature. Args: signature_name: Name of signature to retrieve (default: "default") Returns: Signature content or error Example: get_email_signature()

List all saved email signatures. Returns: Dictionary of all signatures Example: list_email_signatures()

Create a new calendar event. Args: summary: Event title start: Start datetime in ISO format (e.g., "2025-12-05T10:00:00") end: End datetime in ISO format (e.g., "2025-12-05T11:00:00") description: Event description (optional) location: Event location (optional) attendees: Comma-separated list of attendee email addresses (optional) Returns: Created event details including UID Example: create_calendar_event( summary="Team Meeting", start="2025-12-05T10:00:00", end="2025-12-05T11:00:00", description="Discussione sui nuovi progetti", location="Sala Riunioni A", attendees="christopher.caponi@emotion-team.com,marco.rossi@example.com" )

List calendar events within a date range. Args: start_date: Start date in ISO format (default: today) end_date: End date in ISO format (default: 30 days from now) limit: Maximum number of events to return (default: 50) Returns: List of calendar events Example: list_calendar_events( start_date="2025-12-01T00:00:00", end_date="2025-12-31T23:59:59", limit=20 )

Accept a calendar event invitation. Args: event_uid: UID of the event to accept comment: Optional comment for the acceptance Returns: Response status Example: accept_calendar_event( event_uid="abc123@aruba.it", comment="Ci sarò!" )

Decline a calendar event invitation. Args: event_uid: UID of the event to decline comment: Optional comment for the decline Returns: Response status Example: decline_calendar_event( event_uid="abc123@aruba.it", comment="Purtroppo non posso partecipare" )

Mark a calendar event as tentative (maybe attending). Args: event_uid: UID of the event comment: Optional comment Returns: Response status Example: tentative_calendar_event( event_uid="abc123@aruba.it", comment="Forse riesco a partecipare" )

Delete a calendar event. Args: event_uid: UID of the event to delete Returns: Deletion status Example: delete_calendar_event(event_uid="abc123@aruba.it")