Ms365 Cli

---

name: ms365-cli description: Manage Microsoft 365 Emails and Calendar using the ms365 CLI. Trigger this skill when the user needs to "read my email", "send an email", "search emails", "check my calendar", "schedule a meeting", or perform any Outlook/Microsoft 365 email or calendar operations. version: "1.1.0" license: MIT author: thecfguy tools: - bash capabilities: - Email Management (List, Read, Search, Send, Draft, Move, Delete, Folder Management) - Calendar Management (List, Create, Delete, Recurring Events) - Contacts Management (List, Search) tags: - productivity - communication - ms365 - email - calendar

---

Microsoft 365 Skill for OpenClaw

This skill empowers your OpenClaw agent to manage your Microsoft 365 Emails and Calendar directly from the terminal. It leverages the ms365 CLI tool to perform operations securely and efficiently.

Prerequisites

Before using this skill, ensure the ms365 CLI package is installed on the local system or available via npx.

# To install globally:
npm install -g ms365

Requirements:

Node.js 22 or later

A Microsoft 365 account (work, school, or personal)

An Azure AD app registration with delegated permissions

Authentication Lifecycle

The agent cannot authenticate on behalf of the user. The user must manually run these commands beforehand or you can prompt the user to run them in an interactive terminal.

1. Configure Azure App credentials: ms365 auth configure --client-id --tenant-id 2. Login to Microsoft 365: ms365 auth login (Uses Device Code flow; user action required) 3. Check Auth Status: ms365 auth status 4. Logout: ms365 auth logout

---

Capabilities & Usage Instructions

You (the Agent) can use the bash tool to execute ms365 CLI commands to interact with the user's Microsoft 365 account. Below are the allowed operations.

📧 Email Operations

#### List Emails Use this to check recent messages or list items in a specific folder.

Command: ms365 email list

Modifiers:

- -c, --count : Number of results (default: 20) - -f, --folder : Target folder - supports well-known names (inbox, sentitems, drafts, etc.), folder display names (case-insensitive), or folder IDs - --select : Comma-separated fields (e.g., subject,from,bodyPreview) - --list-folders: Show available folders instead of listing emails - --all-folders: List emails from all folders at once

Example: ms365 email list -c 5 -f inbox

Example: ms365 email list --list-folders

#### Read Email Fetches the full content of an email message given its ID.

Command: ms365 email read

Example: ms365 email read AAMkADYzZ1...

#### Search Emails Use Keyword Query Language (KQL) to find specific emails.

Command: ms365 email search ""

Modifiers:

- -c, --count : Result count limit

Example: ms365 email search "from:boss@example.com subject:urgent" -c 10

#### Send Email Compose and send an email directly without drafting it first.

Command: ms365 email send [options]

Modifiers:

- --to : Comma-separated recipient emails (Required) - --subject "": Email subject line - --body "": The content of the email - --cc, --bcc: Additional recipients - --html: Treats the --body as HTML content - --importance : Sets email priority

Example: ms365 email send --to "jane@example.com" --subject "Meeting Notes" --body "Please find the notes attached."

#### Draft Email Create an email that gets saved to the Drafts folder instead of sending immediately.

Command: ms365 email draft [options]

Modifiers: (Same as Send Email)

Example: ms365 email draft --to "team@example.com" --subject "Weekly Update" --body "Draft content here"

#### Move Email Move an email from one folder to another. Supports well-known folder names, custom folder display names, and folder IDs.

Command: ms365 email move

Modifiers:

- --list-folders: Show available folders before moving

Note: can be a well-known folder name (inbox, drafts, sentitems, deleteditems, junkemail, archive, outbox), a folder display name (case-insensitive), or a folder ID.

Example: ms365 email move AAMkAD... archive

Example: ms365 email move AAMkAD... "Archive 2024"

#### Delete Email Moves an email to 'Deleted Items' or deletes it permanently.

Command: ms365 email delete

Modifiers:

- --permanent: Hard-deletes the email bypassing 'Deleted Items'.

Example: ms365 email delete AAMkAD...

#### List Folders List all available mail folders with metadata including unread counts and folder structure.

Command: ms365 email folders list

Modifiers:

- -c, --count : Max number of folders (default: 50) - --select : Comma-separated fields

Example: ms365 email folders list

#### Folder Info Get detailed information about a specific folder by name or ID.

Command: ms365 email folders info

Example: ms365 email folders info inbox

#### Create Folder Create a new custom mail folder.

Command: ms365 email folders create

Modifiers:

- --parent : Parent folder ID for nested folders

Example: ms365 email folders create "Archive 2024"

---

📅 Calendar Operations

#### List Events Fetch upcoming calendar events.

Command: ms365 calendar list

Modifiers:

- -d, --days : Lookahead days limit (default is 7) - --start , --end : ISO 8601 constraints (overrides days) - -c, --count : Maximum entries to return

Example: ms365 calendar list --days 3 -c 10

#### Create Event Schedule a new meeting or blocker on the user's calendar.

Command: ms365 calendar create [options]

Modifiers:

- --subject "