Microsoft Outlook Calendar Integration
Microsoft Outlook Calendar Integration
Connect your Microsoft 365 / Outlook calendar to Marmend to sync your events and manage your schedule directly from the platform.
What You Can Do
With the Microsoft Outlook integration, you can:
- Sync your Outlook calendar to see all events in Marmend
- Real-time updates - changes in Outlook appear in Marmend within minutes
- View meeting details including Teams links, location, and attendees
- Check availability for scheduling interviews and meetings
Connecting Your Microsoft Account
Step 1: Go to Integrations
- Click on Administration in the left sidebar
- Select Integrations
- Find the Microsoft Outlook card
Step 2: Connect Your Account
- Click Connect on the Microsoft Outlook card
- You'll be redirected to Microsoft's sign-in page
- Sign in with your Microsoft 365 account (or select an existing account)
- Review the permissions Marmend is requesting:
- View your profile information
- Read your calendar events
- Click Accept to grant access
Step 3: Verify Connection
After connecting, you'll return to the Integrations page where:
- The Microsoft Outlook card shows a Disconnect button (meaning it's connected)
- Your Outlook calendar events will begin syncing automatically
Viewing Your Calendar
Once connected, your Outlook calendar events appear in Marmend:
- Go to Calendar in the left sidebar
- Your Outlook events sync automatically alongside any other calendars
- Microsoft events are shown with a blue accent color (#0078D4)
What Gets Synced
| Synced | Not Synced |
|---|---|
| Event title (subject) | Private event body content (if marked private) |
| Date and time | |
| Location | |
| Microsoft Teams meeting link | |
| Attendees and their responses | |
| All-day event status | |
| Cancelled/deleted events |
Sync Timing
- Initial sync: Events from the past 30 days and next 90 days
- Ongoing sync: Changes sync within 1-2 minutes via webhook push notifications
- Types: New events, updates, cancellations, and deletions all sync automatically
- Efficient sync: Only changed events are fetched (delta queries), not the entire calendar
How Sync Works
Marmend uses Microsoft's push notification system:
- When you connect, Marmend registers for calendar change notifications
- Whenever anything changes on your Outlook calendar, Microsoft notifies Marmend
- Marmend fetches only the changed events and updates your calendar view
- Subscriptions are automatically renewed every few days - no action needed from you
Disconnecting Your Microsoft Account
If you need to disconnect your Outlook calendar:
- Go to Administration > Integrations
- Find the Microsoft Outlook card
- Click Disconnect
- Confirm the disconnection in the dialog
What Happens When You Disconnect
- Synced events remain in Marmend's history
- New Outlook calendar changes stop syncing
- The webhook subscription is removed
- You can reconnect at any time
Troubleshooting
Events Not Syncing
Symptom: New events in Outlook don't appear in Marmend
Solutions:
- Wait 2-3 minutes - sync isn't instant
- Check that your account is still connected in Administration > Integrations
- Try disconnecting and reconnecting your Microsoft account
"Connection Failed" Error
Symptom: Error when trying to connect
Solutions:
- Make sure you clicked "Accept" on all permissions
- Check if your organization restricts third-party app access
- Contact your IT administrator - they may need to approve Marmend in Azure AD
Account Already Connected
Symptom: "This Microsoft account is already connected" message
Solutions:
- You may have already connected this Microsoft account
- Disconnect the existing connection first, then reconnect
- If connecting a different account, make sure to sign out of the other account on Microsoft's login page
Need to Re-authorize
Symptom: Events stopped syncing after working previously
Solutions:
- Your token may have expired or been revoked
- Go to Administration > Integrations
- Disconnect Microsoft Outlook
- Reconnect your account
Privacy & Security
What Marmend Accesses
- Your calendar event list (titles, times, locations, attendees)
- Your Microsoft profile (name and email for identification)
- Microsoft Teams meeting links (if present on events)
What Marmend Does NOT Access
- Your Outlook emails
- Your OneDrive files
- Your Microsoft Teams chats or channels
- Any other Microsoft 365 data beyond calendar
Data Storage
- Calendar events are stored securely in Marmend's database
- Your Microsoft credentials (tokens) are encrypted
- Data is isolated per company (multi-tenant architecture)
Revoking Access
You can revoke Marmend's access at any time:
- Go to Microsoft Account Security
- Find "Marmend" in the list of apps
- Click Remove access
Or ask your IT admin to remove the app from Azure AD > Enterprise Applications.
Frequently Asked Questions
Q: Does this work with personal Microsoft accounts?
A: Yes, both personal Microsoft accounts (outlook.com, hotmail.com) and Microsoft 365 work accounts are supported.
Q: How often does the calendar sync?
A: Events sync in near real-time through push notifications. Most changes appear within 1-2 minutes.
Q: Can my team see my Outlook events?
A: By default, only you can see your personal calendar in the calendar view. Team visibility depends on your organization's settings.
Q: Can I create events in Outlook from Marmend?
A: Calendar write support (creating/updating events on Outlook) requires the :microsoft_calendar_write feature flag to be enabled by your administrator. Currently, sync is read-only by default.
Q: What happens if my Microsoft password changes?
A: You may need to reconnect your Outlook calendar. Marmend uses refresh tokens, so most password changes don't require reconnection. If sync stops, disconnect and reconnect.
Q: Will this affect my existing Google Calendar connection?
A: No. Microsoft Outlook and Google Calendar integrations are completely independent. You can have both connected simultaneously.
Need Help?
If you're experiencing issues with Microsoft Outlook integration:
- Check the troubleshooting section above
- Contact your organization's administrator
- Reach out to Marmend support