m365-pnp-cli Skill
This skill provides access to the CLI for Microsoft 365 – the official PnP (Patterns and Practices) tool for Microsoft 365 management.
⚠️ IMPORTANT FOR AGENTS
When in doubt, ALWAYS call m365 --help first to see all possibilities!
# Always call help when unsure!
m365 --help
# For specific commands:
m365 login --help
m365 spo --help
m365 teams --help
Installation
The CLI must be installed:
npm install -g @pnp/cli-microsoft365
Or use npx (sandbox):
npx @pnp/cli-microsoft365 --help
Source & Verification
- NPM Package: https://www.npmjs.com/package/@pnp/cli-microsoft365
- GitHub Repo: https://github.com/pnp/cli-microsoft365
- Documentation: https://pnp.github.io/cli-microsoft365
- Author: Microsoft PnP (Patterns and Practices Community)
What can the CLI do?
Supported Workloads
- Microsoft Teams
- SharePoint Online
- OneDrive
- Outlook
- Microsoft To Do
- Microsoft Planner
- Power Automate
- Power Apps
- Microsoft Entra ID
- Microsoft Purview
- Bookings
- And more...
Authentication
- Device Code (default)
- Username/Password
- Client Certificate
- Client Secret
- Azure Managed Identity
- Federated Identity
Commands (Overview)
Login/Logout
m365 login # Device Code Login
m365 logout # Logout
m365 status # Check login status
SharePoint Online (spo)
m365 spo site list # List all sites
m365 spo site get --url <url> # Get site details
m365 spo list list --webUrl <url> # Lists in a site
m365 spo file list # List files
m365 spo folder add # Create folder
Teams
m365 teams channel list # List channels
m365 teams channel get # Get channel details
m365 teams user list # List team members
m365 teams chat list # List chats
m365 teams meeting list # List meetings
OneDrive
m365 onedrive drive list # OneDrive Drives
m365 onedrive file list # List files
m365 onedrive file get # Get file content
Outlook
m365 outlook mail list # List emails
m365 outlook calendar list # List calendar events
Planner
m365 planner task list # Planner Tasks
m365 planner plan get # Get plan details
Azure AD / Entra ID
m365 entra user list # List users
m365 entra group list # List groups
m365 entra app list # List apps
Usage as Assistant - IMPORTANT
⚡ First Step: ALWAYS call help!
# When in doubt - call help first!
m365 --help
# For specific commands:
m365 spo --help
m365 teams --help
m365 login --help
Basic Usage
# Login (Device Code Flow)
m365 login
# Check status
m365 status
# SharePoint: List sites
m365 spo site list
# SharePoint: Get specific site
m365 spo site get --url "https://contoso.sharepoint.com/sites/test"
# Teams: List channels
m365 teams channel list --teamId <team-id>
# OneDrive: Files
m365 onedrive file list
# Outlook: Emails
m365 outlook mail list --folder Inbox
# Planner: Tasks
m365 planner task list
Output Options
# As JSON (default)
m365 spo site list
# As text
m365 spo site list --output text
# Filter with JMESPath
m365 spo site list --query "[?Template==\`GROUP#0\`].{Title:Title, Url:Url}"
Authentication
The CLI uses Device Code Flow by default:
m365 login
# → You'll receive a code on another device
# → Use that code to authenticate with Microsoft
For automated scripts, you can also use:
- Certificate (recommended for production)
- Client Secret (less secure)
- Username/Password (testing only)
Important
- WHEN IN DOUBT: call m365 --help!
- Login required for most commands
- JSON output is easiest to parse
- JMESPath for efficient filtering
- CLI requires Node.js >= 20
