Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MS_CLIENT_ID | No | Backwards compatibility alternative for OUTLOOK_CLIENT_ID. | |
| USE_TEST_MODE | No | Run with mock data instead of making real Microsoft Graph API calls. | false |
| MS_CLIENT_SECRET | No | Backwards compatibility alternative for OUTLOOK_CLIENT_SECRET. | |
| OUTLOOK_CLIENT_ID | No | Your Azure Application (client) ID. Found in the Azure Portal App registrations. | |
| OUTLOOK_CLIENT_SECRET | No | Your Azure Client Secret Value (not the Secret ID). Required for authentication. | |
| OUTLOOK_ALLOWED_RECIPIENTS | No | A list of approved email addresses or domains to restrict sending to. | |
| OUTLOOK_MAX_EMAILS_PER_SESSION | No | Session rate limiting for the send-email tool. Default is unlimited. | unlimited |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| auth | Manage authentication with Microsoft Graph API. action=status (default) checks auth state, action=authenticate starts OAuth flow, action=about shows server info. |
| list-events | Lists upcoming events from your calendar |
| create-event | Creates a new calendar event |
| manage-event | Manage an existing calendar event. action=decline declines an invitation. action=cancel cancels an event you organised. action=delete permanently removes an event. |
| search-emails | Search and list emails. With no query, lists recent emails (like list-emails). Supports search queries, KQL, delta sync, message-id lookup, and conversation listing. |
| read-email | Read email content. Set headersMode=true for forensic headers (DKIM, SPF, Received, Message-ID). |
| send-email | Compose and send an email. Use dryRun=true to preview without sending. Subject to rate limits and recipient allowlist when configured. |
| update-email | Update email state. action=mark-read/mark-unread changes read status. action=flag sets follow-up flag. action=unflag clears flag. action=complete marks flag as done. |
| attachments | Manage email attachments. action=list shows attachments for a message. action=view shows content/metadata. action=download saves to disk. |
| export | Export emails. target=message exports one email. target=messages batch-exports. target=conversation exports a thread. target=mime gets raw MIME/EML content. |
| folders | Manage mail folders. action=list (default) lists folders. action=create creates a folder. action=move moves emails between folders. action=stats gets folder counts for pagination planning. action=delete removes a folder. |
| manage-rules | Manage inbox rules. action=list (default) lists rules. action=create creates a new rule. action=reorder changes rule execution priority. action=delete removes a rule. |
| manage-contact | Manage personal contacts. action=list (default) lists contacts. action=search searches by name/email. action=get retrieves full details. action=create adds a contact. action=update modifies a contact. action=delete removes a contact. |
| search-people | Search for people by relevance (includes contacts, directory, and recent communications). Uses a different API from manage-contact search. |
| manage-category | Manage master categories. action=list (default) lists categories. action=create creates a category. action=update changes name/color. action=delete removes a category. |
| apply-category | Apply, add, or remove categories on email message(s) |
| manage-focused-inbox | Manage Focused Inbox overrides. action=list (default) shows overrides. action=set creates/updates an override. action=delete removes an override. |
| mailbox-settings | Manage mailbox settings. action=get (default) retrieves settings (language, timezone, working hours, auto-replies). action=set-auto-replies configures out-of-office. action=set-working-hours configures work schedule. |
| access-shared-mailbox | Read emails from a shared mailbox you have access to |
| find-meeting-rooms | Search for meeting rooms in your organisation |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |