How do I install the Clippy skill?

Run npx skillmds@latest add dvcrn/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?

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

Clippy by dvcrn — Agent Skill

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

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.

dvcrn Updated Sep 8, 2026 32 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 CLISource: https://github.com/foeken/clippyWorks 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```bashgit clone https://github.com/foeken/clippy.gitcd clippy && bun installbun run src/cli.ts --help```Or link globally: `bun link`## Authentication```bash# Interactive login (opens browser, establishes session)clippy login --interactive# Check auth statusclippy 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 eventsclippy calendar# Specific dayclippy calendar --day tomorrowclippy calendar --day mondayclippy calendar --day 2024-02-15# Week viewclippy calendar --week# With details (description, attendees)clippy calendar --details```### Create Events```bashclippy create-event "Title" 09:00 10:00# Full optionsclippy create-event "Meeting" 14:00 15:00 \ --day tomorrow \ --description "Meeting notes" \ --attendees "alice@company.com,bob@company.com" \ --teams \ --find-room# Recurringclippy create-event "Standup" 09:00 09:15 --repeat dailyclippy create-event "Sync" 14:00 15:00 --repeat weekly --days mon,wed,fri```### Update/Delete Events```bashclippy update-event 1 --title "New Title"clippy update-event 1 --start 10:00 --end 11:00clippy delete-event 1clippy delete-event 1 --message "Need to reschedule"```### Respond to Invitations```bashclippy respond # List pendingclippy respond accept --id <eventId>clippy respond decline --id <eventId> --message "Conflict"clippy respond tentative --id <eventId>```### Find Meeting Times```bashclippy findtimeclippy findtime --attendees "alice@company.com,bob@company.com"clippy findtime --duration 60 --days 5```## Email```bash# Inboxclippy mailclippy mail --unreadclippy mail -n 20clippy mail --search "invoice"# Other foldersclippy mail sentclippy mail draftsclippy mail archive# Read emailclippy mail -r <number># Download attachmentsclippy mail -d <number> -o ~/Downloads```### Send Email```bashclippy send \ --to "recipient@example.com" \ --subject "Subject" \ --body "Message body"# With CC, attachments, markdownclippy send \ --to "alice@example.com" \ --cc "manager@example.com" \ --subject "Report" \ --body "**See attached**" \ --markdown \ --attach "report.pdf"```### Reply/Forward```bashclippy mail --reply <number> --message "Thanks!"clippy mail --reply-all <number> --message "Got it"clippy mail --forward <number> --to-addr "colleague@example.com"```### Email Actions```bashclippy mail --mark-read <number>clippy mail --flag <number>clippy mail --move <number> --to archive```## People/Room Search```bashclippy find "john" # Peopleclippy find "conference" --rooms # Rooms```## JSON Output```bashclippy calendar --jsonclippy mail --json```## ConfigurationProfile directory can be overridden:```bashexport CLIPPY_PROFILE_DIR=~/.config/clippy/my-profile```

Frequently asked questions