office-secretary
by cenralsolution
Calendar & SchedulingBrief
Secure M365 Assistant for Triage, Calendar coordination, and Governance.
Description
What This Skill Does
A Python CLI assistant that connects to Microsoft 365 via delegated permissions to triage email, coordinate calendars, audit OneDrive files, and post messages to Teams. It authenticates through Azure Entra ID using MSAL, so it only accesses data the signed-in user can already see.
Using delegated rather than application permissions means the assistant cannot access data beyond what the signed-in user is already authorized to see, reducing the blast radius of a compromised token.
When to Use It
- Triaging high-priority emails at the start of the workday
- Finding open meeting slots across a colleague's calendar
- Listing orphaned or stale files on OneDrive
- Posting automated alerts to a specific Teams channel
- Auditing inbox without sharing admin credentials
Example Workflow
User asks: Show me my high-priority emails from today
- 1
Authenticates to Microsoft Graph via MSAL using delegated flow with stored CLIENT_ID and TENANT_ID
- 2
Queries the Mail API for messages flagged as high importance received today
- 3
Filters and sorts results by sender and subject
- 4
Returns a formatted list of matching emails
A list of high-priority emails with sender, subject, and received time
Requirements
- Azure Entra ID app registration configured as a Public Client
- Delegated API permissions granted in Azure: Mail.ReadWrite, Calendars.ReadWrite, Files.ReadWrite, ChatMessage.Send
- SECRETARY_CLIENT_ID environment variable (from the Azure app registration)
- SECRETARY_TENANT_ID environment variable (from Azure tenant settings)
- Microsoft 365 account with access to Mail, Calendar, OneDrive, and Teams
Installation
clawhub install cenralsolution/office-secretaryRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.