Agent skill · software engineering · aiskillstore
microsoft-graph-api
This skill should be used when the user asks to "read my emails", "send an email", "compose email", "check my calendar", "get calendar events", "create a meeting", "schedule an event", "add calendar event", "search emails", "list mail folders", "show unread messages", "what meetings do I have", "fetch emails from Microsoft", "access Outlook", or mentions Microsoft Graph, Office 365 email, or Outlook calendar integration.
Why this skill is useful
Adds executable TypeScript scripts for Microsoft Graph API interactions that automate email and calendar management tasks.
What it needs
Requires bun installed locally. Requires microsoft account access. About 3k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Microsoft Graph API Integration Access Microsoft 365 emails and calendar through TypeScript scripts executed via Bun. Overview This skill provides access to Microsoft Graph API for: Email: List, read, search, and send emails Calendar: View, search, and create calendar events All scripts return JSON and handle authentication automatically. Response Format All scripts output JSON with a consistent structure: Success Authentication Required When you receive authrequired, display to the user: Then retry the same command - the script will automatically complete authentication. Authentication Pending User has been shown the code but hasn't completed login yet. Remind them to complete authentication. Error Email Access All scripts are located at ${CLAUDEPLUGINROOT}/skills/microsoft-graph/scripts/. List Emails Read Specific Email Get the ID from the list command output. Search Emails List Mail Folders Send Email Calendar Access List Upcoming Events View Specific Event Search Events Date Formats Relative: today, tomorrow, +7d, +1m, +1y Absolute: ISO format 2024-01-15 or 2024-01-15T14:00:00 Create Calendar Event Multi-Profile Support Store multiple accounts using profiles: Manual Authentication For explicit auth management (listing/deleting profiles): Token Lifecycle Token Type Lifetime Handling ------------ ---------- ---------- Access Token ~1 hour Automatically refreshed Refresh Token ~90 days When expired, scripts return authrequired Users only need to re-authenticate when the refresh token expires (~90 days). Credential Storage Credentials are stored at ~/.config/api-skills/credentials.json. Script Reference Script Purpose -------- --------- emails.ts Email list, read, search, send, and folder operations calendar.ts Calendar view, search, and create operations auth.ts Manual credential management (list, delete profiles) Additional Resources For detailed API reference, see: references/graph-api.md - Microsoft Graph API endpoints and parameters
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/microsoft-graph-api