Outlook MCP Server

List Outlook categories with colors and names.

{
  "tool": "categories-list",
  "parameters": {}
}

Add a label/category or move message to a folder in Outlook

Gli serve: idstring labelsarray

{
  "tool": "label-add",
  "parameters": {
    "id": "<string>",
    "labels": "<array>"
  }
}

Delete Outlook categories permanently (irreversible). Categories organize messages by color and name.

Gli serve: idsarray

{
  "tool": "label-delete",
  "parameters": {
    "ids": "<array>"
  }
}

List Outlook categories for label: query syntax. Case-sensitive.

{
  "tool": "labels-list",
  "parameters": {}
}

Get an Outlook message by ID with flexible field selection

Gli serve: idstring

Puo’ usare: fields contentType excludeThreadHistory

{
  "tool": "message-get",
  "parameters": {
    "id": "<string>"
  }
}

Mark an Outlook message as read

Gli serve: idstring

{
  "tool": "message-mark-read",
  "parameters": {
    "id": "<string>"
  }
}

Move Outlook messages to trash (recoverable).

Gli serve: idsarray

{
  "tool": "message-move-to-trash",
  "parameters": {
    "ids": "<array>"
  }
}

Reply to an Outlook message

Gli serve: idstring bodystring

Puo’ usare: contentType

{
  "tool": "message-respond",
  "parameters": {
    "id": "<string>",
    "body": "<string>"
  }
}

Search Outlook messages using structured query objects with flexible field selection.

Puo’ usare: query fields pageSize pageToken shape contentType excludeThreadHistory

{
  "tool": "message-search",
  "parameters": {
    "query": "<string>",
    "fields": "<string>",
    "pageSize": "<integer>"
  }
}

Send an email message through Outlook

Gli serve: tostring bodystring

Puo’ usare: cc bcc subject contentType

{
  "tool": "message-send",
  "parameters": {
    "to": "<string>",
    "body": "<string>"
  }
}

Returns the profile of the Outlook mailbox currently linked to this session (email, userPrincipalName, tenant). Use this when the user asks "which mailbox am I using?" or to obtain the implicit sender for "send to myself".

{
  "tool": "mailbox-get-profile",
  "parameters": {}
}

Disconnects the Outlook mailbox currently linked to this session/user from this MCP agent. The user will need to log in again before using any Outlook tool. Use this when the user asks to "logout", "scollegare la casella", "disconnect outlook", "remove access". No parameters required.

Disconnects the Outlook mailbox currently linked to this session/user from this MCP agent. The user will need to log in again before using any Outlook tool. Use this when the user asks to "logout", "disconnect the mailbox", "disconnect outlook", "remove access". No parameters required.

{
  "tool": "mailbox-logout",
  "parameters": {}
}

List the attachments of an Outlook message by Graph messageId. Returns metadata only (id, name, contentType, size, isInline) - the actual binary or text content is fetched separately via mailbox-read-attachment. Use this when the user asks "what attachments are in this email" or before reading/analy…

Gli serve: messageIdstring

{
  "tool": "mailbox-list-attachments",
  "parameters": {
    "messageId": "<string>"
  }
}

Read or analyze the content of an Outlook attachment. mode="auto" (default) extracts textual content for PDF (text only, no OCR), DOCX, XLSX/CSV, HTML, plain text; for non-textual binaries returns a signed downloadUrl (TTL 1h). mode="vision" (image/* only) delegates visual analysis to the SAME memor…

Gli serve: messageIdstring attachmentIdstring

Puo’ usare: mode visionPrompt

{
  "tool": "mailbox-read-attachment",
  "parameters": {
    "messageId": "<string>",
    "attachmentId": "<string>"
  }
}

Send an email WITH attachments from the connected Outlook mailbox. Use this instead of message-send when the email needs one or more attachments. Each attachment is provided via exactly one of: `url` (gateway downloads it - works with the download_url of files generated by the Excel/Word MCP, the fi…

Gli serve: toarray attachmentsarray

Puo’ usare: cc bcc subject body contentType saveToSentItems

{
  "tool": "mailbox-send-with-attachments",
  "parameters": {
    "to": "<array>",
    "attachments": "<array>"
  }
}

Read free/busy availability and working hours for up to 20 people or rooms in the same Microsoft 365 organization. Returns availabilityView (0=free, 1=tentative, 2=busy, 3=out of office, 4=working elsewhere) without exposing private event details. Use this when the user asks when colleagues are avai…

Gli serve: schedulesarray startstring endstring

Puo’ usare: timeZone intervalMinutes

{
  "tool": "calendar-get-schedule",
  "parameters": {
    "schedules": "<array>",
    "start": "<string>",
    "end": "<string>"
  }
}

Ask Microsoft Graph to suggest the best common meeting times by crossing the organizer calendar with colleagues or rooms. Use this before creating an appointment when multiple attendees are involved.

Gli serve: attendeesarray startstring endstring

Puo’ usare: timeZone durationMinutes minimumAttendeePercentage activityDomain

{
  "tool": "calendar-find-meeting-times",
  "parameters": {
    "attendees": "<array>",
    "start": "<string>",
    "end": "<string>"
  }
}

Create an Outlook calendar event in the connected organizer mailbox. When attendees are provided, Microsoft sends meeting invitations. Confirm the selected slot with the user before calling this tool.

Gli serve: subjectstring startstring endstring

Puo’ usare: timeZone attendees optionalAttendees body contentType location isOnlineMeeting transactionId

{
  "tool": "calendar-create-event",
  "parameters": {
    "subject": "<string>",
    "start": "<string>",
    "end": "<string>"
  }
}

List or search messages in a SHARED Outlook mailbox (not the personal mailbox of the logged-in user). Requires the user to have Exchange FullAccess delegation on that mailbox. Returns message metadata (id, subject, from, receivedDateTime, bodyPreview); use shared-mailbox-get-message to read the full…

Gli serve: mailboxstring

Puo’ usare: query folder top

{
  "tool": "shared-mailbox-list-messages",
  "parameters": {
    "mailbox": "<string>"
  }
}

Read a message (with full body) from a SHARED Outlook mailbox. messageId is the Graph id returned by shared-mailbox-list-messages.

Gli serve: mailboxstring messageIdstring

{
  "tool": "shared-mailbox-get-message",
  "parameters": {
    "mailbox": "<string>",
    "messageId": "<string>"
  }
}

List the attachments (metadata only: id, name, contentType, size) of a message in a SHARED Outlook mailbox. Use shared-mailbox-read-attachment to read the actual content.

Gli serve: mailboxstring messageIdstring

{
  "tool": "shared-mailbox-list-attachments",
  "parameters": {
    "mailbox": "<string>",
    "messageId": "<string>"
  }
}

Read or analyze the content of an attachment from a SHARED Outlook mailbox. Same behaviour as mailbox-read-attachment: mode="auto" (default) extracts textual content for PDF (text only, no OCR), DOCX, XLSX/CSV, HTML, plain text — for non-textual binaries returns a signed downloadUrl (TTL 1h); mode="…

Gli serve: mailboxstring messageIdstring attachmentIdstring

Puo’ usare: mode visionPrompt

{
  "tool": "shared-mailbox-read-attachment",
  "parameters": {
    "mailbox": "<string>",
    "messageId": "<string>",
    "attachmentId": "<string>"
  }
}

Send an email AS a SHARED Outlook mailbox (the from will be the shared mailbox, not the personal one). Requires the user to have SendAs or SendOnBehalf delegation on that mailbox. Supports small inline attachments: for text files you generate yourself (e.g. .ics calendar invites) pass `contentText`…

Gli serve: mailboxstring toarray bodystring

Puo’ usare: cc subject contentType attachments

{
  "tool": "shared-mailbox-send",
  "parameters": {
    "mailbox": "<string>",
    "to": "<array>",
    "body": "<string>"
  }
}