All Docs
FeaturesSidekickUpdated March 11, 2026

Microsoft 365 & Outlook Integration

Microsoft 365 & Outlook Integration

Sidekick's Microsoft 365 adapter connects your Outlook inbox, Microsoft Calendar, and OneDrive to your AI assistant via the Microsoft Graph API. Once connected, Sidekick can read messages, triage your inbox, track calendar events, and access OneDrive files — all in real time.

What's Included

ServiceCapabilities
OutlookRead and triage inbox, real-time new-message notifications
Microsoft CalendarRead and monitor events, real-time change notifications
OneDriveAccess and reference files in connected workflows

Connecting Your Account

  1. Open the Integrations panel in your Sidekick dashboard.
  2. Find Microsoft 365 under the available connectors.
  3. Click Connect and complete the Microsoft OAuth flow.
  4. Grant the requested permissions (mail, calendar, files).
  5. Your account is now active — Sidekick will begin syncing immediately.

No API keys or manual credential management is required. Authentication is handled entirely through Microsoft's OAuth 2.0 flow.

Real-Time Change Notifications

The adapter subscribes to Microsoft Graph change notifications for both your inbox and calendar. This means Sidekick reacts to new emails and calendar updates as they happen — there is no polling delay.

Notification subscriptions are managed automatically and renewed before they expire.

Permissions Requested

The following Microsoft Graph permission scopes are used by this integration:

  • Mail.Read / Mail.ReadWrite — access Outlook messages
  • Calendars.Read / Calendars.ReadWrite — access calendar events
  • Files.Read / Files.ReadWrite — access OneDrive files
  • offline_access — maintain long-lived access via refresh token

ClawHub Skill Compatibility

Sidekick automatically maps MICROSOFT_* environment variable keys defined in ClawHub community skills (SKILL.md) to this OAuth flow. If you import a skill that was originally built for a self-hosted setup and references keys such as MICROSOFT_CLIENT_ID or MICROSOFT_ACCESS_TOKEN, those references are resolved against your connected Microsoft 365 account — no manual configuration needed.

This is part of Sidekick's broader ClawHub compatibility layer, which translates local binary and credential requirements to equivalent cloud services across all 13,000+ community skills.

Disconnecting Your Account

To revoke access:

  1. Go to Integrations in your dashboard.
  2. Click Microsoft 365 → Disconnect.
  3. Sidekick will immediately stop accessing your Microsoft data and remove stored credentials.

You can also revoke access independently at https://myapps.microsoft.com under App permissions.

Troubleshooting

IssueResolution
Calendar or inbox not syncingDisconnect and reconnect to refresh the OAuth token and notification subscriptions.
Missing permissions errorRe-authorize and ensure all requested scopes are accepted during the OAuth flow.
OneDrive files not accessibleConfirm the account has an active OneDrive license in Microsoft 365 admin.
ClawHub skill not finding credentialsCheck that the skill's SKILL.md uses MICROSOFT_* key naming; other patterns are not auto-mapped.