Ms365

# Microsoft 365 Integration

## Description
Access Microsoft 365 services - Email (Outlook), Calendar, OneDrive, To Do tasks, and Contacts via MS Graph API.

## Activation
Activated when user mentions: outlook, email, calendar, onedrive, microsoft, office 365, o365, ms365, my meetings, my emails, schedule meeting, send email, check calendar, to do, microsoft tasks

## Configuration
Authentication is cached after first login. No environment variables required for device code flow.

For headless/automated operation, set these environment variables:
- MS365_MCP_CLIENT_ID - Azure AD app client ID
- MS365_MCP_CLIENT_SECRET - Azure AD app secret
- MS365_MCP_TENANT_ID - Tenant ID (use "consumers" for personal accounts)

## Available Commands

### Authentication

```bash
# Login via device code (interactive)
python3 /root/clawd/skills/ms365/ms365_cli.py login

# Check authentication status
python3 /root/clawd/skills/ms365/ms365_cli.py status

# List cached accounts
python3 /root/clawd/skills/ms365/ms365_cli.py accounts

# Get current user info
python3 /root/clawd/skills/ms365/ms365_cli.py user
```

### Email (Outlook)

```bash
# List recent emails
python3 /root/clawd/skills/ms365/ms365_cli.py mail list [--top N]

# Read specific email
python3 /root/clawd/skills/ms365/ms365_cli.py mail read MESSAGE_ID

# Send email
python3 /root/clawd/skills/ms365/ms365_cli.py mail send --to "recipient@example.com" --subject "Subject" --body "Message body"
```

### Calendar

```bash
# List upcoming events
python3 /root/clawd/skills/ms365/ms365_cli.py calendar list [--top N]

# Create event
python3 /root/clawd/skills/ms365/ms365_cli.py calendar create --subject "Meeting" --start "2026-01-15T10:00:00" --end "2026-01-15T11:00:00" [--body "Description"] [--timezone "America/Chicago"]
```

### OneDrive Files

```bash
# List files in root
python3 /root/clawd/skills/ms365/ms365_cli.py files list

# List files in folder
python3 /root/clawd/skills/ms365/ms365_cli.py files list --path "Documents"
```...

# MS 365 Skill for Clawdbot

A Clawdbot skill for Microsoft 365 integration via the Graph API.

## Features

- **Email**: Read, send, search, delete messages
- **Calendar**: View, create, update, delete events
- **OneDrive**: Browse, upload, download files
- **To Do**: Manage tasks and lists
- **Contacts**: Search and view contacts
- **OneNote**: Access notebooks and pages
- **Teams** (org mode): Send messages, access chats
- **SharePoint** (org mode): Access sites and documents

## Installation

### 1. Copy Skill to Clawdbot

Clone this repo to your Clawdbot skills directory:

```bash
# For workspace skills
cd <workspace>/skills
git clone https://github.com/YOUR_USERNAME/m365-skill ms365

# Or for managed skills
cd ~/.clawdbot/skills
git clone https://github.com/YOUR_USERNAME/m365-skill ms365
```

Or download directly from releases.

### 2. Install Dependencies

The skill will auto-install via npm, or manually:

```bash
npm install -g @softeria/ms-365-mcp-server
```

### 3. Set Up Authentication

#### Option A: Azure AD App (Recommended)

This method works headless and is required for Docker deployments.

**Step 1: Create Azure AD App Registration**

1. Go to [Azure Portal](https://portal.azure.com)
2. Navigate to **Azure Active Directory** → **App registrations**
3. Click **New registration**
4. Configure:
   - **Name**: `Clawdbot MS365` (or your choice)
   - **Supported account types**:
     - "Personal Microsoft accounts only" for personal use
     - "Accounts in any organizational directory and personal" for both
   - **Redirect URI**: Select "Web" and enter `http://localhost:3365/callback`
5. Click **Register**

**Step 2: Configure API Permissions**

1. In your app registration, go to **API permissions**
2. Click **Add a permission** → **Microsoft Graph** → **Delegated permissions**
3. Add these permissions:

| Permission | Purpose |
|------------|---------|
| `Mail.ReadWrite` | Read and send emails |
| `Mail.Send` | Send emails |
| `Calendars.ReadWrite` | Man...