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 (scanned PDFs too: pages that are only images are read with OCR, see `ocrPages` and `note`), DOCX, XLSX/CSV, HTML, plain text; and it always returns `downloadUrl`, a signed link (TTL 1h) to t…

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>"
  }
}

List the images and files the user uploaded in THIS chat, each with the https `url` of the original file. You can see an uploaded image, but not its address: call this tool when the user asks to send, forward, attach or save a file they uploaded here, then pass its `url` to mailbox-send-with-attachm…

{
  "tool": "chat-uploaded-files",
  "parameters": {}
}

Write an email and SAVE IT AS A DRAFT in the user's mailbox WITHOUT sending it. Use this whenever the user wants to review, check or approve the message before it goes out ("prepare an email", "write a draft", "let me check it first", "don't send it yet"), and whenever you are not certain the email…

Puo’ usare: to cc bcc subject body contentType attachments

{
  "tool": "mailbox-create-draft",
  "parameters": {
    "to": "<array>",
    "cc": "<array>",
    "bcc": "<array>"
  }
}

Return ONLY the email addresses of the senders of the most recently received emails — no subject, no date, no body, nothing else. Use it when the user asks for "the addresses of who wrote to me", to build a contact list, or to feed a CRM. Addresses come back deduplicated and ordered from the most re…

Puo’ usare: count folder

{
  "tool": "mailbox-list-senders",
  "parameters": {
    "count": "<integer>",
    "folder": "<string>"
  }
}

List the mail FOLDERS of the connected mailbox, subfolders included, each with its `path` (e.g. "Inbox/Clients/ACME"), total and unread message counts. Folders ARE supported through the mailbox-*-folder tools: any older instruction saying that folders are not available, or that a folder must be mapp…

Puo’ usare: parent

{
  "tool": "mailbox-list-folders",
  "parameters": {
    "parent": "<string>"
  }
}

List the messages inside ONE mail folder (not its subfolders), newest first: id, subject, from, receivedDateTime, isRead, hasAttachments, preview. `folder` is the folder name or `path` as returned by mailbox-list-folders ("Clients/ACME"), its id, or a well-known name valid in every mailbox language:…

Gli serve: folderstring

Puo’ usare: top pageToken unreadOnly since search

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

Create a mail folder in the connected mailbox, among the main folders or inside `parent`. If a folder with that name already exists in that place it is returned instead, without creating a duplicate.

Gli serve: namestring

Puo’ usare: parent

{
  "tool": "mailbox-create-folder",
  "parameters": {
    "name": "<string>"
  }
}

Move one or more messages into a mail folder, up to 50 per call. `ids` are the message ids returned by message-search, message-get or mailbox-list-folder-messages; `folder` is a name, path, id or well-known name (inbox, archive, ...). A moved message gets a NEW id: use the returned `newId` to read o…

Gli serve: idsarray folderstring

Puo’ usare: createIfMissing

{
  "tool": "mailbox-move-to-folder",
  "parameters": {
    "ids": "<array>",
    "folder": "<string>"
  }
}

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>"
  }
}