Exchange 2010/2013 EWS Skill

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

快速开始

自动配置

邮箱账号和密码会自动配置，无需手动设置：

1. 邮箱密码：使用密码登录 EnnewClaw 时，密码会自动同步到 Exchange
2. 邮箱地址：首次使用邮箱功能时，系统自动通过 DWS 获取你的企业邮箱地址
3. 开始使用！直接使用邮箱、日历等功能即可

密码验证失败

如果自动同步的密码与邮箱密码不一致，使用时会提示：

> Exchange 邮箱密码验证失败。请在对话中提供正确的邮箱密码，我会更新配置后重新尝试连接。

提供正确密码后，调用 update_exchange_password 即可更新：

from skills.exchange2010 import update_exchange_password
result = update_exchange_password('correct-password')

Setup (English)

Credentials are auto-configured:

1. Password: Synced automatically when you log in to EnnewClaw with your password
2. Email: Auto-discovered from DWS on first use
3. No manual configuration needed!

If password verification fails

If the saved password doesn't match your email password, you'll be prompted to provide the correct one. Use update_exchange_password to update it:

from skills.exchange2010 import update_exchange_password
result = update_exchange_password('correct-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('shared@company.com')

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='shared@company.com',
    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='boss@company.com', limit=10)

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

# Unread only
emails = search_emails(is_unread=True, limit=20)

Mark Email as Read

from skills.exchange2010 import mark_email_as_read

mark_email_as_read(email_id='AAQkAG...')

Download Attachments

from skills.exchange2010 import get_email_attachments

# Show info
attachments = get_email_attachments(email_id='AAQkAG...')
for att in attachments:
    print(f"{att['name']}: {att['size']} bytes")

# Download
attachments = get_email_attachments(
    email_id='AAQkAG...',
    download_path='/tmp/email_attachments'
)

Extract Text from Attachments

Prerequisite: pip install PyPDF2 for PDF text extraction

from skills.exchange2010 import process_attachment_content

results = process_attachment_content(email_id='AAQkAG...')
for result in results:
    print(f"File: {result['name']}")
    if 'extracted_text' in result:
        print(f"Content: {result['extracted_text'][:500]}...")

Search Contacts

from skills.exchange2010 import search_contacts, resolve_name

# Search contacts
contacts = search_contacts('John Doe')
for c in contacts:
    print(f"{c['name']}: {c['email']}")

# Resolve name (GAL)
result = resolve_name('john.doe@company.com')
if result:
    print(f"Found: {result['name']} - {result['email']}")

Manage Tasks

from skills.exchange2010 import get_tasks, create_task, complete_task, delete_task
from datetime import datetime, timedelta

# Show open tasks
tasks = get_tasks()
for task in tasks:
    status = '✅' if task['is_complete'] else '⏳'
    print(f"{status} {task['subject']}")

# Create new task
task_id = create_task(
    subject="Finish report",
    body="Q1 report due Friday",
    due_date=datetime.now() + timedelta(days=3),
    importance="High"
)

# Mark as complete
complete_task(task_id)

# Delete
delete_task(task_id)

Find Recurring Events

from skills.exchange2010 import get_recurring_events

recurring = get_recurring_events(
    email_address='shared@company.com',
    days=30
)
for r in recurring:
    print(f"{r['subject']}: {r['recurrence']}")

Out-of-Office

from skills.exchange2010 import get_out_of_office, set_out_of_office
from datetime import datetime, timedelta

# Check status
oof = get_out_of_office()
print(f"Out of office active: {oof['enabled']}")

# Enable
set_out_of_office(
    enabled=True,
    internal_reply="I am on vacation until Feb 15th.",
    external_reply="I am on vacation until Feb 15th.",
    start=datetime.now(),
    end=datetime.now() + timedelta(days=7),
    external_audience='All'  # 'All', 'Known', 'None'
)

# Disable
set_out_of_office(enabled=False, internal_reply="")

Send Email

from skills.exchange2010 import send_email

send_email(
    to=["recipient@example.com"],
    subject="Test",
    body="Hello!",
    cc=["cc@example.com"]
)

API Reference

Email

Email Folders

Calendar

Contacts

Tasks

Out-of-Office

Credential Management

Notes

• Exchange 2010 SP2 explicitly used as version
• DELEGATE access type for own and shared mailboxes
• EWS Filters (subject__contains, start__gte) are faster than iteration
• Timezones: Automatic conversion to EWSDateTime with UTC
• 28 functions available in total (including credential management)

Security Considerations

⚠️ Important: This skill requires live Exchange credentials and provides broad mailbox access.

• Use least-privilege credentials
• Verify credential configuration before use
• Protect the .env.credentials file
• Require explicit confirmation before sending mail or modifying Exchange data
• Restrict attachment downloads to a safe directory with sanitized filenames