O

Outlook Delegate

outlook-skill-clawhub

Read, search, and manage Outlook emails and calendar via Microsoft Graph API with delegate support. Your AI assistant authenticates as itself but accesses the owner's mailbox/calendar as a delegate. Modified for delegate access from https://clawhub.ai/jotamed/outlook

数据来源：ClawHub。在 ClawSkills 查看

661下载量

0收藏数

2浏览量

安装

选择你使用的 Agent

方法一：命令行安装（推荐）

关于 Outlook Delegate

--- name: outlook-delegate description: Read, search, and manage Outlook emails and calendar via Microsoft Graph API with delegate support. Your AI assistant authenticates as itself but accesses the owner's mailbox/calendar as a delegate. Modified for delegate access from https://clawhub.ai/jotamed/outlook version: 1.0.0 author: 87marc ---

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., [email protected])
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

| Feature | Direct Access (/me) | Delegate Access (/users/{id}) | |---------|----------------------|--------------------------------| | API Base | /me/messages | /users/{owner}/messages | | Send Email | Appears "From: Owner" | Appears "From: Assistant on behalf of Owner" | | Calendar | Full control | Based on permission level granted | | Permissions | Mail.ReadWrite, Mail.Send | Mail.ReadWrite.Shared, Mail.Send.Shared, Calendars.ReadWrite.Shared |

Configuration

Config File: `~/.outlook-mcp/config.json`

{
  "client_id": "your-app-client-id",
  "client_secret": "your-app-client-secret",
  "owner_email": "[email protected]",
  "delegate_email": "[email protected]"
}

The owner_email is the mailbox the assistant will access as a delegate.

Setup Requirements

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 "[email protected]" -User "[email protected]" -AccessRights FullAccess

# Grant Send-on-Behalf
Set-Mailbox -Identity "[email protected]" -GrantSendOnBehalfTo "[email protected]"

# Grant calendar access (Editor = can create/modify events)
Add-MailboxFolderPermission -Identity "[email protected]:\Calendar" -User "[email protected]" -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/{[email protected]}/ endpoint.

Usage

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 <email> [count]    # Owner's mail from sender
./scripts/outlook-mail.sh read <id>               # Read email content

Managing Owner's Emails

./scripts/outlook-mail.sh mark-read <id>          # Mark as read
./scripts/outlook-mail.sh mark-unread <id>        # Mark as unread
./scripts/outlook-mail.sh flag <id>               # Flag as important
./scripts/outlook-mail.sh delete <id>             # Move to trash
./scripts/outlook-mail.sh archive <id>            # Move to archive
./scripts/outlook-mail.sh move <id> <folder>      # Move to folder

Sending Emails (On Behalf Of Owner)

./scripts/outlook-mail.sh send <to> <subj> <body>  # Send on behalf of owner
./scripts/outlook-mail.sh reply <id> "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 <id>           # Event details
./scripts/outlook-calendar.sh free <start> <end>  # Owner's availability

Creating Events on Owner's Calendar

./scripts/outlook-calendar.sh create <subj> <start> <end> [location]
./scripts/outlook-calendar.sh quick <subject> [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": "[email protected]"
      }
    },
    "toRecipients": [{"emailAddress": {"address": "[email protected]"}}],
    "body": {"contentType": "Text", "content": "..."}
  }
}

The recipient sees: "Assistant on behalf of Owner "

Permissions Summary

| Action | Required Permission | Exchange Setting | |--------|-------------------|-----------------| | Read owner's mail | Mail.ReadWrite.Shared | FullAccess or Reviewer | | Modify owner's mail | Mail.ReadWrite.Shared | FullAccess or Editor | | Send as owner | Mail.Send.Shared | SendOnBehalf | | Read owner's calendar | Calendars.ReadWrite.Shared | Reviewer+ | | Create events on owner's calendar | Calendars.ReadWrite.Shared | Editor |

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 "[email protected]" -GrantSendOnBehalfTo "[email protected]"

"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)

Changelog

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)

Prompt 示例

安装 Outlook Delegate 后，可以对 AI 说这些话来触发它

U

Send a Slack message to the #engineering channel about the deployment

A

Formats and sends the message with relevant context, tagging the right people

U

Summarize all unread messages in my inbox from today

A

Reads messages across connected channels and returns a prioritized summary

U

Draft a reply to this customer complaint and send it for review

A

Writes an empathetic, professional response and routes it to the approval queue

常见问题

如何安装 Outlook Delegate？▾

将技能文件夹放到 ~/.claude/skills/outlook-skill-clawhub/ 目录（个人级，所有项目可用），或 .claude/skills/outlook-skill-clawhub/（项目级）。重启 AI 客户端后，用 /outlook-skill-clawhub 主动调用，或让 AI 根据上下文自动发现并使用。

Outlook Delegate 支持哪些 AI 平台？▾

Outlook Delegate 支持 Claude、Cursor、OpenClaw，可与这些 AI 平台无缝集成，扩展其能力。

Outlook Delegate 是免费的吗？▾

Outlook Delegate 可免费安装使用。请查阅仓库了解许可证信息。

Outlook Delegate 有什么功能？▾

Read, search, and manage Outlook emails and calendar via Microsoft Graph API with delegate support. Your AI assistant authenticates as itself but accesses the owner's mailbox/calendar as a delegate. Modified for delegate access from https://clawhub.ai/jotamed/outlook

Outlook Delegate 属于哪个分类？▾

Outlook Delegate 属于「Communication」分类，该分类的技能帮助 AI 智能体在此领域执行专业任务。

使用场景

Getting Started with Outlook Delegate→Automate Communication Workflows with Outlook Delegate→Team Collaboration with Outlook Delegate→

Outlook Delegate

安装

关于 Outlook Delegate

Outlook Delegate Skill

Delegate Architecture

What Changed from Direct Access

Configuration

Config File: `~/.outlook-mcp/config.json`

Setup Requirements

1. Azure AD App Registration

2. Exchange Delegate Permissions (Admin or Owner)

3. Token Flow

Usage

Token Management

Reading Owner's Emails

Managing Owner's Emails

Sending Emails (On Behalf Of Owner)

Owner's Calendar

Creating Events on Owner's Calendar

API Endpoint Changes

Send-on-Behalf Implementation

Permissions Summary

Troubleshooting

Security Considerations

Files

Changelog

v1.0.0 (Delegate Edition)

Prompt 示例

常见问题

使用场景

同类技能推荐

歌革

PollyReach

Agent Phone Call

Slack

Outlook Delegate

安装

关于 Outlook Delegate

Outlook Delegate Skill

Delegate Architecture

What Changed from Direct Access

Configuration

Config File: ~/.outlook-mcp/config.json

Setup Requirements

1. Azure AD App Registration

2. Exchange Delegate Permissions (Admin or Owner)

3. Token Flow

Usage

Token Management

Reading Owner's Emails

Managing Owner's Emails

Sending Emails (On Behalf Of Owner)

Owner's Calendar

Creating Events on Owner's Calendar

API Endpoint Changes

Send-on-Behalf Implementation

Permissions Summary

Troubleshooting

Security Considerations

Files

Changelog

v1.0.0 (Delegate Edition)

Prompt 示例

常见问题

使用场景

同类技能推荐

歌革

PollyReach

Agent Phone Call

Slack

Config File: `~/.outlook-mcp/config.json`