M365 Mail

What it does

This skill provides a command-line interface (CLI) tool for interacting with Microsoft 365 email using the Microsoft Graph API. It allows AI agents to send and receive emails, read message content, and search inboxes. The tool automates common email tasks, enabling streamlined workflows and increased productivity within the Microsoft 365 environment.

When to use it

• Automating repetitive email actions like sending standard replies or forwarding messages.
• Retrieving specific email information based on keywords or sender.
• Checking for unread emails containing important updates.
• Integrating email interactions into larger automated workflows.
• Reading and processing the content of individual emails programmatically.

Key capabilities

• Sending Emails: Allows agents to send new email messages through Microsoft 365.
• Receiving Emails: Enables retrieval of recent emails from an inbox.
• Message Reading: Provides functionality to read full or truncated versions of email content.
• Email Search: Supports searching for emails based on keywords, sender, and other criteria (unread status, attachments).
• JSON Output: Offers the ability to output data in JSON format for easier parsing by other tools.

Example prompts

• "Retrieve the last 20 unread emails from my inbox."
• "Send an email to [email protected] with the subject 'Issue Report' and body 'Please investigate...'"
• "Search my inbox for emails containing the phrase 'quarterly report'."

Tips & gotchas

• Setup Required: This skill requires initial setup involving registering an Entra ID app, configuring API permissions (Mail.ReadWrite, Mail.Send), enabling a public client flow, and providing your Application (client) ID and Directory (tenant) ID.
• Authentication: The tool uses device code flow for authentication, which will open a browser window to complete the login process.
• Permissions: Ensure that the Entra ID app has been granted administrator consent for the necessary Microsoft Graph permissions.