ews-mcp/.env.example at main · konsisumer/ews-mcp · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
# Exchange Server Configuration
# You can provide any of these formats:
#   - Full URL: https://mail.company.com/EWS/Exchange.asmx
#   - Hostname with protocol: https://mail.company.com
#   - Just hostname: mail.company.com
# The server will automatically construct the full EWS endpoint URL
EWS_SERVER_URL=mail.company.com
EWS_EMAIL=user@company.com
EWS_AUTODISCOVER=false

# Authentication (choose one)
EWS_AUTH_TYPE=oauth2  # oauth2, basic, ntlm

# OAuth2 Settings (if using OAuth2)
EWS_CLIENT_ID=your-client-id
EWS_CLIENT_SECRET=your-client-secret
EWS_TENANT_ID=your-tenant-id

# Basic Auth Settings (if using Basic)
EWS_USERNAME=user@company.com
EWS_PASSWORD=your-password

# Server Configuration
MCP_SERVER_NAME=ews-mcp-server
MCP_TRANSPORT=stdio  # stdio or sse (use sse for HTTP/SSE transport)
MCP_HOST=0.0.0.0     # Only used when MCP_TRANSPORT=sse
MCP_PORT=8000        # Only used when MCP_TRANSPORT=sse
LOG_LEVEL=INFO

# OpenAPI/REST API Configuration (Optional - for custom API URLs)
# External URL for API access (e.g., https://ews-api.company.com)
# API_BASE_URL=https://ews-api.example.com
# Internal Docker network URL (e.g., http://ews-mcp:8000)
# API_BASE_URL_INTERNAL=http://ews-mcp:8000
# Customize API metadata
# API_TITLE=Exchange Web Services (EWS) MCP API
# API_DESCRIPTION=REST API for Exchange operations via Model Context Protocol
# API_VERSION=3.4.0

# Timezone Configuration (CRITICAL for proper datetime handling)
# Use IANA timezone names: UTC, America/New_York, Europe/London, Asia/Riyadh, etc.
# Do NOT use UTC offsets like UTC+03:00 - they will cause errors
TIMEZONE=UTC

# Performance
ENABLE_CACHE=true
CACHE_TTL=300
CONNECTION_POOL_SIZE=10
REQUEST_TIMEOUT=30

# Rate Limiting
RATE_LIMIT_ENABLED=true
RATE_LIMIT_REQUESTS_PER_MINUTE=25

# Features
ENABLE_EMAIL=true
ENABLE_CALENDAR=true
ENABLE_CONTACTS=true
ENABLE_TASKS=true
ENABLE_FOLDERS=true
ENABLE_ATTACHMENTS=true

# Security
ENABLE_AUDIT_LOG=true
MAX_ATTACHMENT_SIZE=157286400

# Impersonation/Delegation (optional)
# Enable to allow operating on behalf of other users
# Requires ApplicationImpersonation role (impersonation) or delegate access (delegate)
EWS_IMPERSONATION_ENABLED=false
# Access type: 'impersonation' (service account with ApplicationImpersonation role)
#              'delegate' (user delegation through Outlook/Exchange)
EWS_IMPERSONATION_TYPE=impersonation