Microsoft Workspace Skill
Andrew-Girgis/microsoft-workspace-skill
Hermes Agent skill for Outlook mail, calendar and contacts through the Microsoft Graph API
Microsoft Workspace Skill is a Hermes Agent skill that connects the agent to Outlook mail, calendar and contacts through the Microsoft Graph API. It works with Hotmail, Outlook.com and Microsoft 365 accounts.
What Microsoft Workspace Skill does
Microsoft Workspace Skill gives Hermes Agent access to Outlook through the Microsoft Graph API. It works with Hotmail, Outlook.com and Microsoft 365 accounts, and email is its primary focus: the agent can list, search and read messages, filter by unread or importance, send mail with attachments up to 3MB, reply, reply-all, forward, and move messages between folders. A safe sender with preview mode avoids shell variable problems when composing.
Calendar support covers listing, creating, updating and deleting events, sending invites with branded HTML templates and Teams video links, checking free/busy status for one or more people, and finding open slots where all attendees are free. Contacts and profile lookups are read-only. Setup uses an Azure App Registration with delegated Graph permissions, a credentials script, and an OAuth browser step. The token is saved under ~/.hermes and refreshes automatically.
Key features
- List, search and read email with unread, importance and folder filters
- Send, reply, reply-all and forward, with attachments up to 3MB
- Create, update and delete calendar events, including invites with Teams video links
- Free/busy checks and open-slot search across attendees
- Contact listing and user profile lookup
- Credentials and token stored under ~/.hermes with automatic token refresh
When to use it
- Ask Hermes to summarize unread or important Outlook mail
- Have the agent find a time when several people are free and send the invite
- Draft, preview and send an email with an attachment from a chat with the agent
Who it is for: Hermes Agent users who keep their mail and calendar in Outlook.com, Hotmail or Microsoft 365.
How it fits with Hermes Agent
Built as a skill for Hermes Agent, with its credentials and tokens kept in the ~/.hermes directory.
Requirements: Python 3.8+, the msal package, a Microsoft account (Hotmail, Outlook.com or Microsoft 365), and a free Azure App Registration
FAQ
What is Microsoft Workspace Skill?
Microsoft Workspace Skill is a Hermes Agent skill that integrates Outlook email, calendar and contacts through the Microsoft Graph API. It works with Hotmail, Outlook.com and Microsoft 365 accounts.
What do I need to run Microsoft Workspace Skill?
You need Python 3.8 or newer, the msal package, a Microsoft account and an Azure App Registration, which the README says is free and takes about five minutes. The registration needs delegated Graph permissions for calendars, mail, user profile and contacts.
Is Microsoft Workspace Skill free and open source?
The repository has no license file, so default copyright applies and you should check with the author before reuse. The source code is public on GitHub.
Similar skills for Hermes Agent
All skillsAgent skills for psychology experiment programming and reproducible data analysis
DeployFaith Hermes Bible SkillCommunity knowledge-base skill for Hermes Agent with 169 documentation pages and real-world flows
JuneYaooo MediWise Health SuiteLocal family health records, diet tracking and medical document skill for AI agents
indigokarasu FinchHermes skill that mines session history for corrections and patterns and feeds them back into memory
1lystore AwaekHermes and OpenClaw skill that lets you chat with your saved X bookmarks, stored locally in SQLite
krumjahn Threads Growth SkillHermes Agent skill that learns from your Threads Insights to draft and score better posts
Related guides: What is Hermes Agent? · SOUL.md for Hermes Agent: what it is and how to write one