M365 Graph MCP

List messages from a user or shared mailbox folder. Supports search, OData filtering, folder scoping, and pagination. Args: mailbox: Target mailbox UPN/ID. folder_id: Folder ID or well-known name. search: Free-text search string. filt

Retrieve the full content of a single message by ID. Args: message_id: The message ID. mailbox: Target mailbox UPN/ID. response_format: 'markdown' or 'json'. Returns: str: Markdown rendering or full JSON message resource.

Send a new e-mail from a user or shared mailbox. In test mode (GRAPH_TEST_MODE=true) all recipients are redirected to the approved test address. Graph sends only from M365 mailboxes; a Gmail address cannot be a sender. Args: subject: Message subject.

Reply (or reply-all) to an existing message. Args: message_id: ID of the message to reply to. comment: Reply text to prepend. reply_all: Reply to all recipients. mailbox: Target mailbox UPN/ID. Returns: str: Confirmation s

Create a draft message without sending it. Args: subject: Draft subject. body: Draft body content. to_recipients: Recipient addresses. body_type: Body type: 'HTML' or 'Text'. mailbox: Target mailbox UPN/ID. Returns:

Move a message to a different mail folder. Args: message_id: ID of the message to move. destination_folder_id: Destination folder ID or well-known name. mailbox: Target mailbox UPN/ID. Returns: str: JSON with the new message id, or "E

Delete a message (moves it to Deleted Items). Args: message_id: ID of the message to delete. mailbox: Target mailbox UPN/ID. Returns: str: Confirmation string or "Error: <message>".

List mail folders in a user or shared mailbox. Supports three modes: - Top-level folders (default) - Direct children of a specific parent (parent_folder_id) - Full recursive subfolder tree (recursive=true) Args: mailbox: Target mailbox UPN/ID.

Create a mail folder, optionally nested under a parent folder. Args: display_name: Folder name to create. parent_folder_id: Parent folder ID or well-known name (e.g. 'inbox'). Omit for mailbox root. mailbox: Target mailbox UPN/ID. Returns:

Rename an existing mail folder. Args: folder_id: ID of the folder to rename. display_name: New folder name. mailbox: Target mailbox UPN/ID. Returns: str: JSON with folder id and new displayName, or "Error: <message>".

Delete a mail folder and all messages it contains. This is destructive: deleting a folder removes its contents. Args: folder_id: ID of the folder to delete. mailbox: Target mailbox UPN/ID. Returns: str: Confirmation string or "Error: <me

List calendar events, optionally within a date range. When both start and end are supplied, uses Graph calendarView to expand recurring events across the window. Args: mailbox (Optional[str]): Target mailbox UPN/ID. start_datetime (Optional[str]): IS

Retrieve full detail of a single event by ID. Args: event_id (str): The event ID. mailbox (Optional[str]): Target mailbox UPN/ID. response_format (str): 'markdown' or 'json'. Returns: str: Markdown detail or full JSON event resource.

Create a calendar event, optionally as a Teams online meeting. Attendee addresses are redirected to the approved test recipient in test mode (GRAPH_TEST_MODE=true). Args: subject (str): Event subject. start_datetime (str): ISO 8601 start (e.g. '2026-

Update fields on an existing event. Only supplied fields change. Args: event_id (str): The event ID. subject (Optional[str]): New subject. start_datetime (Optional[str]): New ISO 8601 start. end_datetime (Optional[str]): New ISO 8601 end.

Delete (cancel) a calendar event. Args: event_id (str): The event ID. mailbox (Optional[str]): Target mailbox UPN/ID. Returns: str: Confirmation string or "Error: <message>".

Query free/busy availability for one or more mailboxes. Args: schedules (List[str]): Mailbox addresses to check. start_datetime (str): ISO 8601 window start. end_datetime (str): ISO 8601 window end. time_zone (str): Time zone for the window.

List contacts in a user or shared mailbox. Args: mailbox (Optional[str]): Target mailbox UPN/ID. search (Optional[str]): displayName prefix filter. top (int): Max contacts to return. skip (int): Contacts to skip (pagination). respo

Retrieve a single contact by ID. Args: contact_id (str): The contact ID. mailbox (Optional[str]): Target mailbox UPN/ID. response_format (str): Output format: 'markdown' or 'json'. Returns: str: Markdown detail or full JSON contact re

Create a new contact. Args: given_name (str): First name. surname (Optional[str]): Last name. email_addresses (Optional[List[str]]): E-mail addresses. mobile_phone (Optional[str]): Mobile number. business_phones (Optional[List[str]

Update fields on a contact. Only supplied fields change. Note: email_addresses replaces the entire existing list. Args: contact_id (str): The contact ID. given_name (Optional[str]): First name. surname (Optional[str]): Last name. emai

Delete a contact. Args: contact_id (str): The contact ID. mailbox (Optional[str]): Target mailbox UPN/ID. Returns: str: Confirmation string or "Error: <message>".

Discover mailboxes in the directory (users and shared mailboxes). Useful to find the address of a shared mailbox before targeting it with Mail, Calendar, or Contacts tools via their `mailbox` parameter. Requires the User.Read.All application permission. Args:

Read a mailbox's settings, including time zone and auto-replies. Requires MailboxSettings.Read (or ReadWrite) application permission. Args: mailbox (str): Target mailbox UPN/ID. response_format: 'json' (default) or 'markdown'. Returns: s

Configure automatic replies (out-of-office) on a mailbox. Requires MailboxSettings.ReadWrite application permission. Args: mailbox (str): Target mailbox UPN/ID. internal_message (str): Reply for internal senders. status: 'disabled' | 'alwaysEnabl

List all inbox rules for a user or shared mailbox. Args: mailbox (Optional[str]): Target mailbox UPN/ID. response_format (str): 'markdown' or 'json'. Returns: str: Markdown summary or JSON with schema: {"items": [rule...], "count"

Retrieve a single inbox rule by ID. Args: rule_id (str): The rule ID. mailbox (Optional[str]): Target mailbox UPN/ID. response_format (str): 'json' (default) or 'markdown'. Returns: str: Full JSON rule resource or Markdown summary.

Create an inbox rule from common conditions and actions. At least one action must be supplied. Forward targets are redirected to the approved test address in test mode. Args: display_name (str): Rule name. sequence (int): Execution order among rules

Update an inbox rule. Only supplied fields change. Supplying any condition field replaces the rule's conditions block; supplying any action field replaces the actions block. Metadata (name, sequence, enabled) is patched independently. Args: rule_id (str)

Delete an inbox rule. Args: rule_id (str): The rule ID. mailbox (Optional[str]): Target mailbox UPN/ID. Returns: str: Confirmation string or "Error: <message>".

Query Business Partners from SAP B1.

Query Items and stock levels from SAP B1.

Query Sales Orders from SAP B1.

Query any authorised SAP B1 entity (e.g., Invoices, PurchaseOrders).