Connect your Outlook account to Goodweek to manage emails, calendar events, contacts, To Do tasks, and mailbox settings directly from your AI workspace.
ℹ️ Governance note
Goodweek will never exceed the access levels granted to the user within Outlook, guaranteeing alignment with your organization's governance policies. Outcomes and available features may vary depending on each user's specific permissions and authenticated access.
📋 Prerequisites
Before any user can see and connect the Outlook integration, your organization admin must first enable it from the Goodweek Admin Panel under the Integrations tab.
Admin Setup
The Outlook integration uses Microsoft OAuth 2.0 via Microsoft Entra ID. To allow users to connect, a Microsoft Entra tenant admin must grant admin consent for the application. Without this step, users may see a permission error during the connection flow.
There are three typical scenarios depending on your Entra ID configuration:
Admin consent has already been granted. Users can connect directly without any additional steps.
User consent is disabled in your tenant. An Entra admin must grant consent on behalf of the organization before users can connect. Go to Microsoft Entra admin center → Enterprise Applications → Composio → Permissions → Grant admin consent for [your organization].
Access to mailbox or calendar data is restricted at the resource level. Depending on your organization's Exchange or Entra settings, additional permissions may need to be configured before the integration can access mailbox content.
⚠️ Important: Microsoft admin session edge case
If a Microsoft Entra tenant admin completes the OAuth connection flow themselves, Microsoft may apply admin consent automatically and link the integration to the admin's account rather than to their individual user account. This is a Microsoft behavior and cannot be changed at the OAuth level.
Recommended approach: The admin should pre-approve the app in Entra ID (Enterprise Applications → Composio → Permissions → Grant admin consent for your organization) before any user — including the admin — goes through the Goodweek connection flow. Once pre-approved, any user including the admin can complete the flow and the integration will be linked to their individual account.
Alternatively, a non-admin user can complete the connection flow first to avoid this issue.
User Connection
In Goodweek, go to Integrations.
Find Outlook and click Connect.
You will be redirected to Microsoft, where you will be asked to sign in with your Microsoft account and authorize access.
Click Accept to grant access and return to Goodweek.
Important Notes
Each user must connect their own account individually.
Goodweek can only access the emails, calendar events, and contacts that belong to the account you authorize.
You can revoke Goodweek's access at any time from Microsoft account → My Account → Privacy → Apps and services → Composio → Remove access.
Available Tools
Tool | Description | Type |
Get Email Message | Retrieves a specific email message by its ID from the user's Outlook mailbox. | Read |
Get Mail Folder | Retrieves a mail folder by ID or well-known name (Inbox, Sent, Drafts). | Read |
Get Mail Delta | Retrieves incremental changes to messages in a mailbox for synchronization. | Read |
Get Drafts Mail Folder | Retrieves details about the drafts folder including item count. | Read |
Get Mail Tips | Retrieves mail tips for recipients such as automatic replies or mailbox full status. | Read |
Create Email Draft | Creates a new Outlook email draft with subject, body, recipients, and optional attachments. | Write |
Create a Draft Reply | Creates a draft reply to an existing message for review before sending. | Write |
Create Forward Draft | Creates a draft forward of an existing message that can be edited before sending. | Write |
Create Reply-All Draft | Creates a draft reply-all to a message for review before sending. | Write |
Forward Message | Forwards an existing email to new recipients. | Write |
Add Mail Attachment | Adds an attachment to an email message by its ID. | Write |
Download Outlook Attachment | Downloads a specific file attachment from an email message. | Read |
Create Mail Folder | Creates a new mail folder to organize email. | Write |
Batch Move Messages | Moves up to 20 Outlook messages to a destination folder in a single call. | Read |
Batch Update Messages | Updates up to 20 Outlook messages in a single call, such as marking them as read. | Write |
Create Email Rule | Creates an email rule with conditions and actions for automated message handling. | Write |
Get Calendar View | Retrieves events active during a specified time window, including multi-day events. | Read |
Get Calendar Event | Retrieves full details of a specific calendar event by its ID. | Read |
Get Calendar Schedule | Retrieves free/busy schedule information for users, distribution lists, or resources. | Read |
Find Meeting Times | Suggests meeting times based on organizer and attendee availability and duration requirements. | Read |
Create Calendar Event | Creates a new Outlook calendar event with start time, end time, attendees, and location. | Write |
Create Event in Specific Calendar | Creates a new event in a specific named calendar for a user. | Write |
Accept Calendar Event Invite | Accepts or tentatively accepts a calendar meeting invite on behalf of the user. | Read |
Create Calendar | Creates a new calendar in the user's mailbox for organizing events separately. | Write |
Get User's Default Calendar | Retrieves properties and relationships of the signed-in user's default calendar. | Read |
Get Calendar Event Attachment | Retrieves a specific attachment from a calendar event. | Read |
Add Event Attachment | Adds an attachment to a specific Outlook calendar event. | Write |
Get Contact | Retrieves a specific Outlook contact by its ID. | Read |
Create Contact | Creates a new contact in a Microsoft Outlook user's contacts folder. | Write |
Create Contact Folder | Creates a new contact folder in the user's mailbox for organizing contacts. | Write |
Get Contact Photo | Downloads the binary profile photo of a contact. | Read |
Create To Do Task | Creates a new task in Microsoft To Do within a specified task list. | Write |
Get Mailbox Settings | Retrieves mailbox settings such as automatic replies, time zone, and language. | Read |
Get Supported Languages | Retrieves supported languages configured in the user's mailbox. | Read |
Get Supported Time Zones | Retrieves supported time zones for the user's mailbox server. | Read |
Get User by Email | Retrieves user details from Microsoft Graph by email address or userPrincipalName. | Read |
Get Outlook Profile | Retrieves the Microsoft Outlook profile for a specified user. | Read |
Get Master Categories | Retrieves all categories defined in the user's master category list. | Read |
Create User Master Category | Creates a new category in the user's master category list. | Write |
Get Inference Classification | Retrieves Focused Inbox classification settings for the authenticated user. | Read |
Create User Focused Inbox Override | Creates a Focused Inbox override for a specific sender to control message routing. | Write |
Decline Calendar Event | Declines a calendar event invitation on behalf of the user. | ⚠️ Destructive |
Cancel User Calendar Event | Cancels a calendar event and sends cancellation notifications to all attendees. | ⚠️ Destructive |
Delete Calendar Event | Permanently deletes a calendar event from the user's Outlook calendar. | ⚠️ Destructive |
Delete Calendar | Deletes a calendar other than the default calendar from the user's mailbox. | ⚠️ Destructive |
Delete Message | Permanently deletes an Outlook email message by its ID. | ⚠️ Destructive |
Delete Mail Folder | Deletes a mail folder from the user's mailbox. | ⚠️ Destructive |
Delete Contact | Permanently deletes an existing contact by its ID. | ⚠️ Destructive |
Delete Email Rule | Permanently deletes an email rule. This action is irreversible. | ⚠️ Destructive |
Delete To Do Task | Permanently deletes a task from a Microsoft To Do task list. | ⚠️ Destructive |
Use Cases
Draft and manage emails from conversations. Create email drafts, draft replies, and forwards directly from Goodweek without switching to Outlook — useful for composing responses while reviewing other context in the same workspace.
Check availability and schedule meetings. Retrieve calendar views, find open meeting slots based on attendee availability, and create calendar events directly from Goodweek to schedule meetings without navigating Outlook.
Manage contacts and tasks. Create new contacts, add them to contact folders, and add tasks to Microsoft To Do from Goodweek to keep people and action items organized after a meeting or conversation.
Organize your inbox with rules and folders. Create mail folders and email rules from Goodweek to automate message routing and keep the inbox organized without configuring them manually in Outlook.
Troubleshooting
Permission error during connection
Your Microsoft Entra tenant admin may need to grant consent for the application. Ask your admin to follow the Admin Setup steps above before attempting to reconnect.
Integration not visible in Goodweek
Make sure your organization admin has enabled the Outlook integration from the Goodweek Admin Panel under the Integrations tab.