Clippy - Microsoft 365 CLI

# Clippy - Microsoft 365 CLI

Source: https://github.com/foeken/clippy

Works through the M365 web UI via browser automation (Playwright), not the Graph API. No Azure AD app registration required - just login with your browser.

## Install

```bash git clone https://github.com/foeken/clippy.git cd clippy && bun install bun run src/cli.ts --help ```

Or link globally: `bun link`

## Authentication

```bash # Interactive login (opens browser, establishes session) clippy login --interactive

# Check auth status clippy whoami ```

### Keepalive (recommended)

Keep a browser session alive to prevent token expiry:

```bash # Start keepalive (keeps browser open, refreshes every 10min) clippy keepalive --interval 10 ```

For persistent operation, set up as a launchd service (macOS) or systemd (Linux).

**Health monitoring:** Keepalive writes to `~/.config/clippy/keepalive-health.txt` on each successful refresh. Check if this file is stale (>15min) to detect failures.

## Calendar

```bash # Today's events clippy calendar

# Specific day clippy calendar --day tomorrow clippy calendar --day monday clippy calendar --day 2024-02-15

# Week view clippy calendar --week

# With details (description, attendees) clippy calendar --details ```

### Create Events

```bash clippy create-event "Title" 09:00 10:00

# Full options clippy create-event "Meeting" 14:00 15:00 \ --day tomorrow \ --description "Meeting notes" \ --attendees "[email protected],[email protected]" \ --teams \ --find-room

# Recurring clippy create-event "Standup" 09:00 09:15 --repeat daily clippy create-event "Sync" 14:00 15:00 --repeat weekly --days mon,wed,fri ```

### Update/Delete Events

```bash clippy update-event 1 --title "New Title" clippy update-event 1 --start 10:00 --end 11:00 clippy delete-event 1 clippy delete-event 1 --message "Need to reschedule" ```

### Respond to Invitations

```bash clippy respond # List pending clippy respond accept --id <eventId> clippy respond decline --id <eventId> --message "Conflict" clippy respond tentative --id <eventId> ```

### Find Meeting Times

```bash clippy findtime clippy findtime --attendees "[email protected],[email protected]" clippy findtime --duration 60 --days 5 ```

## Email

```bash # Inbox clippy mail clippy mail --unread clippy mail -n 20 clippy mail --search "invoice"

# Other folders clippy mail sent clippy mail drafts clippy mail archive

# Read email clippy mail -r <number>

# Download attachments clippy mail -d <number> -o ~/Downloads ```

### Send Email

```bash clippy send \ --to "[email protected]" \ --subject "Subject" \ --body "Message body"

# With CC, attachments, markdown clippy send \ --to "[email protected]" \ --cc "[email protected]" \ --subject "Report" \ --body "**See attached**" \ --markdown \ --attach "report.pdf" ```

### Reply/Forward

```bash clippy mail --reply <number> --message "Thanks!" clippy mail --reply-all <number> --message "Got it" clippy mail --forward <number> --to-addr "[email protected]" ```

### Email Actions

```bash clippy mail --mark-read <number> clippy mail --flag <number> clippy mail --move <number> --to archive ```

## People/Room Search

```bash clippy find "john" # People clippy find "conference" --rooms # Rooms ```

## JSON Output

```bash clippy calendar --json clippy mail --json ```

## Configuration

Profile directory can be overridden: ```bash export CLIPPY_PROFILE_DIR=~/.config/clippy/my-profile ```