# Send Outlook Delegate to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "outlook-skill-clawhub", "name": "Outlook Delegate", "source": "tencent", "type": "skill", "category": "效率提升", "sourceUrl": "https://clawhub.ai/87Marc/outlook-skill-clawhub", "canonicalUrl": "https://clawhub.ai/87Marc/outlook-skill-clawhub", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/outlook-skill-clawhub", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=outlook-skill-clawhub", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/outlook-skill-clawhub" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/outlook-skill-clawhub", "downloadUrl": "https://openagent3.xyz/downloads/outlook-skill-clawhub", "agentUrl": "https://openagent3.xyz/skills/outlook-skill-clawhub/agent", "manifestUrl": "https://openagent3.xyz/skills/outlook-skill-clawhub/agent.json", "briefUrl": "https://openagent3.xyz/skills/outlook-skill-clawhub/agent.md" } } ``` ## Documentation ### Outlook Delegate Skill Access another user's Outlook/Microsoft 365 email and calendar as a delegate via Microsoft Graph API. ### Delegate Architecture This skill is designed for scenarios where: Your AI assistant has its own Microsoft 365 account (e.g., assistant@domain.com) The owner has granted the assistant delegate access to their mailbox/calendar The assistant authenticates as itself but accesses the owner's resources ### What Changed from Direct Access FeatureDirect Access (/me)Delegate Access (/users/{id})API Base/me/messages/users/{owner}/messagesSend EmailAppears "From: Owner"Appears "From: Assistant on behalf of Owner"CalendarFull controlBased on permission level grantedPermissionsMail.ReadWrite, Mail.SendMail.ReadWrite.Shared, Mail.Send.Shared, Calendars.ReadWrite.Shared ### Config File: ~/.outlook-mcp/config.json { "client_id": "your-app-client-id", "client_secret": "your-app-client-secret", "owner_email": "owner@domain.com", "delegate_email": "assistant@domain.com" } The owner_email is the mailbox the assistant will access as a delegate. ### 1. Azure AD App Registration The app registration needs delegated permissions (not application permissions): Mail.ReadWrite.Shared - Read/write access to shared mailboxes Mail.Send.Shared - Send mail on behalf of others Calendars.ReadWrite.Shared - Read/write shared calendars User.Read - Read assistant's own profile offline_access - Refresh tokens ### 2. Exchange Delegate Permissions (Admin or Owner) The owner must grant the assistant delegate access via Exchange/Outlook: PowerShell (Admin): # Grant mailbox access Add-MailboxPermission -Identity "owner@domain.com" -User "assistant@domain.com" -AccessRights FullAccess # Grant Send-on-Behalf Set-Mailbox -Identity "owner@domain.com" -GrantSendOnBehalfTo "assistant@domain.com" # Grant calendar access (Editor = can create/modify events) Add-MailboxFolderPermission -Identity "owner@domain.com:\\Calendar" -User "assistant@domain.com" -AccessRights Editor -SharingPermissionFlags Delegate Or via Outlook Settings: The owner can add the assistant as a delegate in Outlook → File → Account Settings → Delegate Access. ### 3. Token Flow The assistant authenticates as itself via OAuth2, then accesses the owner's resources using the /users/{owner@domain.com}/ endpoint. ### Token Management ./scripts/outlook-token.sh refresh # Refresh expired token ./scripts/outlook-token.sh test # Test connection to BOTH accounts ./scripts/outlook-token.sh get # Print access token ### Reading Owner's Emails ./scripts/outlook-mail.sh inbox [count] # Owner's inbox ./scripts/outlook-mail.sh unread [count] # Owner's unread ./scripts/outlook-mail.sh search "query" [count] # Search owner's mail ./scripts/outlook-mail.sh from [count] # Owner's mail from sender ./scripts/outlook-mail.sh read # Read email content ### Managing Owner's Emails ./scripts/outlook-mail.sh mark-read # Mark as read ./scripts/outlook-mail.sh mark-unread # Mark as unread ./scripts/outlook-mail.sh flag # Flag as important ./scripts/outlook-mail.sh delete # Move to trash ./scripts/outlook-mail.sh archive # Move to archive ./scripts/outlook-mail.sh move # Move to folder ### Sending Emails (On Behalf Of Owner) ./scripts/outlook-mail.sh send # Send on behalf of owner ./scripts/outlook-mail.sh reply "body" # Reply on behalf of owner Note: Emails will show "Assistant on behalf of Owner" in the From field. ### Owner's Calendar ./scripts/outlook-calendar.sh events [count] # Owner's upcoming events ./scripts/outlook-calendar.sh today # Owner's today ./scripts/outlook-calendar.sh week # Owner's week ./scripts/outlook-calendar.sh read # Event details ./scripts/outlook-calendar.sh free # Owner's availability ### Creating Events on Owner's Calendar ./scripts/outlook-calendar.sh create [location] ./scripts/outlook-calendar.sh quick [time] ### API Endpoint Changes The key change is replacing /me with /users/{owner_email}: # Direct access (old) API="https://graph.microsoft.com/v1.0/me" # Delegate access (new) OWNER=$(jq -r '.owner_email' "$CONFIG_FILE") API="https://graph.microsoft.com/v1.0/users/$OWNER" ### Send-on-Behalf Implementation When sending mail as a delegate, you must specify the from address: { "message": { "subject": "Meeting follow-up", "from": { "emailAddress": { "address": "owner@domain.com" } }, "toRecipients": [{"emailAddress": {"address": "recipient@example.com"}}], "body": {"contentType": "Text", "content": "..."} } } The recipient sees: "Assistant on behalf of Owner owner@domain.com" ### Permissions Summary ActionRequired PermissionExchange SettingRead owner's mailMail.ReadWrite.SharedFullAccess or ReviewerModify owner's mailMail.ReadWrite.SharedFullAccess or EditorSend as ownerMail.Send.SharedSendOnBehalfRead owner's calendarCalendars.ReadWrite.SharedReviewer+Create events on owner's calendarCalendars.ReadWrite.SharedEditor ### Troubleshooting "Access denied" or "403 Forbidden" → Check that the assistant has MailboxPermission on the owner's mailbox "The mailbox is not found" → Verify owner_email in config.json is correct "Insufficient privileges" → App registration missing .Shared permissions (check Azure AD) Emails send but don't show "on behalf of" → Missing SendOnBehalf permission. Run: Set-Mailbox -Identity "owner@domain.com" -GrantSendOnBehalfTo "assistant@domain.com" "Token expired" → Run outlook-token.sh refresh ### Security Considerations Audit Trail: All actions by the assistant are logged in the owner's mailbox audit log Token Storage: Credentials stored in ~/.outlook-mcp/ - protect this directory Scope Limitation: The assistant only has access to what the owner explicitly grants Revocation: The owner can revoke access anytime via Delegate settings ### Files ~/.outlook-mcp/config.json - Client ID, secret, and owner/delegate emails ~/.outlook-mcp/credentials.json - OAuth tokens (access + refresh) ### v1.0.0 (Delegate Edition) Breaking: API calls now use /users/{owner} instead of /me Added: owner_email and delegate_email config fields Added: Send-on-behalf support with proper from field Changed: Permissions to .Shared variants Added: Delegate setup documentation Added: Token test validates access to owner's mailbox Based on outlook v1.3.0 by jotamed (https://clawhub.ai/jotamed/outlook) ## Trust - Source: tencent - Verification: Indexed source record - Publisher: 87Marc - Version: 1.0.0 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-30T16:55:25.780Z - Expires at: 2026-05-07T16:55:25.780Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/outlook-skill-clawhub) - [Send to Agent page](https://openagent3.xyz/skills/outlook-skill-clawhub/agent) - [JSON manifest](https://openagent3.xyz/skills/outlook-skill-clawhub/agent.json) - [Markdown brief](https://openagent3.xyz/skills/outlook-skill-clawhub/agent.md) - [Download page](https://openagent3.xyz/downloads/outlook-skill-clawhub)