Sync, search, read, and send Stanford Office 365 email via the Microsoft Graph API.
npx skills add https://github.com/rishabh-ranjan/dotfiles --skill email-rishabh-ranjan
Please help me install this Agent Skill. Skill: email Source: https://github.com/rishabh-ranjan/dotfiles/tree/main/.claude/skills/email Command: npx skills add https://github.com/rishabh-ranjan/dotfiles --skill email-rishabh-ranjan
~/Mail/Stanford/ for indexing with notmuch, mutt, or similar tools, with incremental sync based on stored timestamps. - Search and Read: Query the mailbox via the Graph $search endpoint and fetch individual messages by Graph ID, with HTML bodies stripped for terminal display. - Send and Draft: Send plain-text or HTML email with optional CC/BCC directly from the command line. - Use Case: Ask the agent to search your Stanford inbox for messages from a specific sender last week; it syncs the mailbox, runs a notmuch query, and summarizes the matching threads. ## Quick Start Ask the agent to search your Stanford email for recent messages about a specific topic, and it will authenticate, sync, and return matching results.High-intent search queries and answers about installing and using this skill.
Use the Microsoft Graph API with device-code authentication to access the mailbox directly. The office365_sync.py script supports search, read, folders, and send commands, and syncs messages to a local Maildir for use with notmuch or mutt.
Run the sync command, which downloads all mail folders into ~/Mail/Stanford/ in Maildir format. Incremental sync uses a stored timestamp in sync_state.json to fetch only new messages, and the --full flag re-checks everything without re-downloading existing files.
Yes, the Graph API operates over HTTPS and does not depend on IMAP being enabled by the tenant administrator. If the default public client ID is blocked, you can register your own app in the Entra portal and replace the CLIENT_ID in the script.
Some tenants block the default MSAL public client application. The fix is to register your own application at entra.microsoft.com and replace the CLIENT_ID constant in the script, then re-run the auth command.
The script does not support calendar access, contacts, or multiple accounts. Refresh tokens can expire after roughly 90 days of inactivity, requiring re-authentication, and Graph search cannot always combine $search with $orderby on all tenants.
microsoftRegister Microsoft Entra ID apps and configure OAuth/MSAL workflows.
FalkorDBCreate RediSearch-backed full-text indexes and query FalkorDB graph nodes.
billyfranklim1Schedule recurring tasks with cron and systemd-timer compatible settings.
bolander72Sync IMAP mailboxes to local Maildir for offline reading and searching.