How do I install the Clippy skill?

Run npx skillmds@latest add modbender/clippy in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Clippy safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Clippy?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Clippy free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Clippy?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Clippy by modbender — Agent Skill

Name: Clippy
Rating: 4.2 (5 reviews)
Author: modbender

Clippy

Microsoft 365 / Outlook CLI for calendar and email. Use when managing Outlook calendar (view, create, update, delete events, find meeting times, respond to invitations), sending/reading emails, or searching for people/rooms in the organization.

modbender Updated Sep 9, 2026 12 repo stars

File contents

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

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

Or link globally: bun link

Authentication

# 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:

# 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

# 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

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

# Full options
clippy create-event "Meeting" 14:00 15:00 \
  --day tomorrow \
  --description "Meeting notes" \
  --attendees "alice@company.com,bob@company.com" \
  --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

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

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

Find Meeting Times

clippy findtime
clippy findtime --attendees "alice@company.com,bob@company.com"
clippy findtime --duration 60 --days 5

Email

# 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

clippy send \
  --to "recipient@example.com" \
  --subject "Subject" \
  --body "Message body"

# With CC, attachments, markdown
clippy send \
  --to "alice@example.com" \
  --cc "manager@example.com" \
  --subject "Report" \
  --body "**See attached**" \
  --markdown \
  --attach "report.pdf"

Reply/Forward

clippy mail --reply <number> --message "Thanks!"
clippy mail --reply-all <number> --message "Got it"
clippy mail --forward <number> --to-addr "colleague@example.com"

Email Actions

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

People/Room Search

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

JSON Output

clippy calendar --json
clippy mail --json

Configuration

Profile directory can be overridden:

export CLIPPY_PROFILE_DIR=~/.config/clippy/my-profile

---name: clippydescription: Microsoft 365 / Outlook CLI for calendar and email. Use when managing Outlook calendar (view, create, update, delete events, find meeting times, respond to invitations), sending/reading emails, or searching for people/rooms in the organization.--- # 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 "alice@company.com,bob@company.com" \ --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 "alice@company.com,bob@company.com" 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 "recipient@example.com" \ --subject "Subject" \ --body "Message body" # With CC, attachments, markdown clippy send \ --to "alice@example.com" \ --cc "manager@example.com" \ --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 "colleague@example.com" ``` ### 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 ```

Frequently asked questions