@apilium/outlook-mail

Outlook email integration skill for Mayros -- read, send, search, and manage folders via Microsoft Graph API.

Installation

Copy this skill directory into your Mayros skills folder:

cp -r skills/outlook-mail ~/.mayros/skills/outlook-mail

Or install via the Mayros CLI:

mayros skill install @apilium/outlook-mail

Configuration

This skill requires a Microsoft Graph API access token.

Set the access token

export MS_GRAPH_ACCESS_TOKEN="your-token-here"

Quick token via Azure CLI

If you have the Azure CLI installed:

export MS_GRAPH_ACCESS_TOKEN="$(az account get-access-token --resource https://graph.microsoft.com --query accessToken -o tsv)"

Required permissions (delegated)

• Mail.Read
• Mail.Send
• Mail.ReadWrite

Usage

Once configured, the agent can:

• List messages: View recent emails sorted by date
• Read messages: Fetch full email content with body and recipients
• Search emails: Find messages by keyword using KQL
• Send email: Compose and send (with user confirmation)
• Manage folders: List, move messages between folders
• Reply: Reply to existing messages
• Attachments: List message attachments

Example prompts

"Show me my latest emails"
"Search my inbox for messages about the quarterly report"
"Send an email to [email protected] about the project deadline"
"Move that message to the Archive folder"
"Reply to the last email from Bob"

Semantic Predicates

| Predicate | Scope | Description | |-----------|-------|-------------| | outlook:mail_sent | agent | Emails sent by the agent | | outlook:mail_read | agent | Messages read by the agent |

Read/Unread Annotations

The skill automatically annotates query results:

• read -- Message has been read
• unread -- Message has not been read
• stale -- Message is older than 48 hours

License

MIT