io.github.ap311036/ews-meeting-mcp

Official

by ap311036 · Python

EWS Meeting MCP

Safely schedule Outlook meetings on on-prem Exchange EWS with preview-confirmed writes.

Schedule Outlook meetings on Exchange EWS with confirmation.

Install

Configuration

Environment variables

EWS_ENDPOINTrequired

Exchange EWS endpoint, for example https://mail.company.com/EWS/Exchange.asmx

EWS_EMAILrequired

Mailbox email address used as the meeting organizer.

EWS_USERNAMErequired

Exchange login username, often DOMAIN\username for NTLM.

EWS_PASSWORDsecret

Exchange password. Prefer macOS Keychain variables when possible.

EWS_PASSWORD_KEYCHAIN_SERVICE

Optional macOS Keychain service name for reading the password locally.

EWS_PASSWORD_KEYCHAIN_ACCOUNT

Optional macOS Keychain account. Defaults to EWS_USERNAME when omitted.

EWS_AUTH_TYPEdefault NTLM

Exchange auth type. Usually NTLM for on-prem Exchange.

EWS_TIMEZONEdefault Asia/Taipei

IANA timezone for calendar operations.

claude_desktop_config.json

{
  "mcpServers": {
    "ews-meeting-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ews-meeting-mcp@0.1.17"
      ],
      "env": {
        "EWS_ENDPOINT": "<YOUR_EWS_ENDPOINT>",
        "EWS_EMAIL": "<YOUR_EWS_EMAIL>",
        "EWS_USERNAME": "<YOUR_EWS_USERNAME>",
        "EWS_PASSWORD": "<YOUR_EWS_PASSWORD>",
        "EWS_PASSWORD_KEYCHAIN_SERVICE": "<YOUR_EWS_PASSWORD_KEYCHAIN_SERVICE>",
        "EWS_PASSWORD_KEYCHAIN_ACCOUNT": "<YOUR_EWS_PASSWORD_KEYCHAIN_ACCOUNT>",
        "EWS_AUTH_TYPE": "NTLM",
        "EWS_TIMEZONE": "Asia/Taipei"
      }
    }
  }
}