184 lines
7.2 KiB
Markdown
184 lines
7.2 KiB
Markdown
---
|
|
name: exchange-mcp
|
|
description: >-
|
|
Use this skill when the user talks about
|
|
email, calendar, contacts, Exchange, EWS, corporate mail,
|
|
or scheduling meetings.
|
|
---
|
|
|
|
# exchange-mcp — MCP server for Microsoft Exchange
|
|
|
|
This MCP server provides access to **Microsoft Exchange Server** via **Exchange
|
|
Web Services (EWS)** with NTLM authentication. Supports email, calendar,
|
|
contacts, and free/busy scheduling.
|
|
|
|
**Use this server when the user talks about:**
|
|
|
|
- Email, inbox, sent items, drafts
|
|
- Calendar, events, meetings, availability
|
|
- Contacts, people, colleagues, employees
|
|
- Attachments, files in emails
|
|
- Exchange, EWS, corporate mail
|
|
|
|
**Does not support:** Microsoft 365 / Exchange Online (OAuth), IMAP/POP3/SMTP,
|
|
Gmail, Outlook.com.
|
|
|
|
---
|
|
|
|
## Tools
|
|
|
|
### Auth
|
|
|
|
#### `login`
|
|
|
|
Authenticate to Exchange EWS via NTLM. On first use, all fields except `domain`
|
|
are required. On subsequent logins, only `password` is needed — previously saved
|
|
`serverUrl`, `email`, `username`, and `domain` are reused automatically.
|
|
|
|
| Parameter | Type | Required | Description |
|
|
| ----------- | ------ | -------- | ------------------------------------------------ |
|
|
| `serverUrl` | string | no* | EWS server URL (e.g. `https://mail.example.com`) |
|
|
| `email` | string | no* | Email address |
|
|
| `username` | string | no* | NTLM username |
|
|
| `password` | string | yes | NTLM password |
|
|
| `domain` | string | no | NTLM domain (default: `corp`) |
|
|
|
|
\* Required only on first login; skipped on subsequent logins (loaded from saved
|
|
config).
|
|
|
|
**Usage guidance:** If the user asks to log in and only provides a password
|
|
(without `serverUrl`, `email`, or `username`), this is likely a *repeated*
|
|
login — the previously saved config will be reused automatically. Just call the
|
|
`login` tool with the password alone.
|
|
|
|
#### `check_session`
|
|
|
|
Check if the current session is authenticated. No parameters. Returns
|
|
`{authenticated, email, serverUrl}`.
|
|
|
|
#### `logout`
|
|
|
|
Clear stored credentials. No parameters.
|
|
|
|
---
|
|
|
|
### Email
|
|
|
|
#### `get_emails`
|
|
|
|
Get emails from a folder. Supports optional text search via
|
|
`query`/`queryScope`.
|
|
|
|
| Parameter | Type | Default | Description |
|
|
| ------------- | ------- | --------- | ----------------------------------------------------------------------------------- |
|
|
| `folder` | string | `"Inbox"` | Folder name (Inbox, Sent, Drafts, Deleted, Junk, or custom; supports Russian names) |
|
|
| `limit` | number | `10` | Max emails (max 50; max 500 if `idsOnly=true`) |
|
|
| `offset` | number | `0` | Pagination offset |
|
|
| `includeBody` | boolean | `false` | If `true`, fetches full email body |
|
|
| `unreadOnly` | boolean | `false` | Only unread emails |
|
|
| `idsOnly` | boolean | `false` | Return only IDs + dates + subjects (faster, higher limit) |
|
|
| `query` | string | — | Text to search for within the folder |
|
|
| `queryScope` | enum | `"all"` | Scope: `all`, `subject`, `body`, `from` (only when `query` is set) |
|
|
|
|
#### `get_email`
|
|
|
|
Get a single email with full body and details.
|
|
|
|
| Parameter | Type | Required | Description |
|
|
| --------- | ------ | -------- | ---------------------------- |
|
|
| `itemId` | string | yes | Exchange ItemId of the email |
|
|
|
|
#### `mark_email_read`
|
|
|
|
Mark emails as read or unread.
|
|
|
|
| Parameter | Type | Default | Description |
|
|
| --------- | -------- | ------- | ------------------------------- |
|
|
| `itemIds` | string[] | — | List of Exchange ItemIds |
|
|
| `isRead` | boolean | `true` | `true` = read, `false` = unread |
|
|
|
|
#### `download_attachments`
|
|
|
|
Download all file attachments from an email to disk.
|
|
|
|
| Parameter | Type | Default | Description |
|
|
| -------------- | ------ | -------------------- | --------------- |
|
|
| `itemId` | string | — | Exchange ItemId |
|
|
| `targetFolder` | string | `"/tmp/attachments"` | Local folder |
|
|
|
|
---
|
|
|
|
### Folders
|
|
|
|
#### `get_folders`
|
|
|
|
List mailbox folders.
|
|
|
|
| Parameter | Type | Default | Description |
|
|
| ---------------- | ------- | ----------------- | ----------------------------------------------------------------- |
|
|
| `parentFolderId` | string | `"msgfolderroot"` | Parent folder (supports distinguished names: `inbox`, `calendar`) |
|
|
| `recursive` | boolean | `false` | Recursively traverse subfolders |
|
|
|
|
---
|
|
|
|
### Calendar
|
|
|
|
#### `get_calendar_events`
|
|
|
|
Get calendar events within a date range.
|
|
|
|
| Parameter | Type | Required | Description |
|
|
| ------------- | ------- | -------- | ----------------------------------------- |
|
|
| `startDate` | string | yes | Start (`YYYY-MM-DD`) |
|
|
| `endDate` | string | yes | End (`YYYY-MM-DD`) |
|
|
| `includeBody` | boolean | `false` | Full details (organizer, attendees, body) |
|
|
|
|
#### `download_event_attachments`
|
|
|
|
Download attachments from a calendar event. Same parameters as
|
|
`download_attachments`.
|
|
|
|
---
|
|
|
|
### Availability
|
|
|
|
#### `find_free_time`
|
|
|
|
Find free time slots in your calendar.
|
|
|
|
| Parameter | Type | Default | Description |
|
|
| ----------------- | ------ | ----------- | -------------------------- |
|
|
| `startDate` | string | — | Start (`YYYY-MM-DD`) |
|
|
| `endDate` | string | = startDate | End |
|
|
| `durationMinutes` | number | `30` | Minimum slot duration |
|
|
| `startHour` | number | `9` | Work day start hour (0-23) |
|
|
| `endHour` | number | `18` | Work day end hour (0-23) |
|
|
|
|
#### `find_meeting_time`
|
|
|
|
Find common free time for multiple people.
|
|
|
|
| Parameter | Type | Default | Description |
|
|
| ----------------- | ------ | ----------- | --------------------------------- |
|
|
| `emails` | string | — | Attendee emails (comma-separated) |
|
|
| `startDate` | string | — | Start |
|
|
| `endDate` | string | = startDate | End |
|
|
| `durationMinutes` | number | `30` | Minimum slot duration |
|
|
| `startHour` | number | `9` | Work day start hour |
|
|
| `endHour` | number | `18` | Work day end hour |
|
|
|
|
---
|
|
|
|
### People
|
|
|
|
#### `find_person`
|
|
|
|
Search for people in the corporate directory (Active Directory).
|
|
|
|
| Parameter | Type | Required | Description |
|
|
| --------- | ------ | -------- | ----------------------- |
|
|
| `query` | string | yes | Name, email, or keyword |
|
|
|
|
Returns: name, email, job title, department, company, office, phone, manager,
|
|
direct reports.
|