exchange2010

Exchange 2010 EWS integration for emails, calendar, contacts, and tasks.

Setup

Requires credentials in .env.credentials:

EXCHANGE_SERVER=mail.company.com
EXCHANGE_DOMAIN=company
[email protected]
EXCHANGE_PASSWORD=your_password

Features

• ✅ Email: Read unread, send, search, mark as read
• ✅ Email Attachments: Download, extract text (PDF, TXT)
• ✅ Email Folders: Browse Sent, Drafts, Trash, Junk
• ✅ Calendar: View, create, update, delete, search events
• ✅ Recurring Events: Detect and manage series
• ✅ Shared Calendars: Access other Exchange mailboxes
• ✅ Contacts: Search address book, resolve names (GAL)
• ✅ Tasks/To-Do: Manage, create, complete tasks
• ✅ Out-of-Office: Read and set absence messages
• ✅ EWS Filters: Fast search with subject__contains, start__gte, etc.
• ✅ List Calendars: Show all calendar folders

Examples

Read Emails

from skills.exchange2010 import get_account, get_unread_emails

account = get_account()
emails = get_unread_emails(account, limit=10)
for email in emails:
    print(f"{email['subject']} from {email['sender']}")

Today's Events

from skills.exchange2010 import get_today_events

# Your own events
today = get_today_events()

# Events from shared calendar
today = get_today_events('[email protected]')

Search Events

from skills.exchange2010 import search_calendar_by_subject
from datetime import date

# Fast search for Ekadashi
ekadashi = search_calendar_by_subject(
    email_address='[email protected]',
    search_term='Ekadashi',
    start_date=date(2025, 1, 1),
    end_date=date(2026, 12, 31)
)
print(f"Found: {len(ekadashi)} events")

Create Event

from skills.exchange2010 import create_calendar_event
from datetime import datetime

create_calendar_event(
    subject="Team Meeting",
    start=datetime(2026, 2, 7, 14, 0),
    end=datetime(2026, 2, 7, 15, 0),
    body="Project discussion",
    location="Conference Room A"
)

Update Event

from skills.exchange2010 import update_calendar_event
from datetime import datetime

# Reschedule
update_calendar_event(
    event_id='AAQkAG...',
    start=datetime(2026, 2, 10, 14, 0),
    end=datetime(2026, 2, 10, 15, 0),
    location="New Room B"
)

Browse Email Folders

from skills.exchange2010 import get_folder_emails, list_email_folders

# List all folders
folders = list_email_folders(account)
for f in folders:
    print(f"{f['name']}: {f['unread_count']} unread")

# Sent Items
sent = get_folder_emails('sent', limit=10)

# Drafts
drafts = get_folder_emails('drafts')

# Trash
trash = get_folder_emails('trash')

Search Emails

from skills.exchange2010 import search_emails

# By sender
emails = search_emails(sender='[email protected]', limit=10)

# By subject
emails = search_emails(subject='Invoice', folder='inbox')