Outlook Email app
Make ChatGPT more actionable with your Outlook mailbox, people directory, and saved contacts. The Outlook Email app enables ChatGPT to securely search and reference messages, look up people, and—when actions are enabled—create and manage Outlook contacts and contact folders.
Learn more about connecting a new app.
Example use cases and prompts
Communication and writing
“Summarize the latest update from [sender] about this project.”
“Draft a reply that covers the three main points in the last email from [sender].”
Organization and productivity
“Show my latest emails from the finance team.”
“List unread emails from yesterday.”
“Find emails from:[name] subject:[keyword] after:2025-10-01.”
Analysis and reporting
“Create a table of sender, subject, and date for emails about [topic] in the last 7 days.”
“Identify action items from the last three emails about [project].”
Capabilities and Permissions
What it can do
Search and retrieve messages from the signed-in user’s mailbox, including metadata such as subject, sender, recipients, timestamps, and plain-text body.
Support keyword and structured message searches such as from:, subject:, and date filters.
Return full message text for results returned by search.
Search relevant people, work or school directory users, and saved mailbox contacts.
List and retrieve Outlook contacts and contact folders.
Create, update, and delete Outlook contacts and contact folders when actions are enabled.
Permission requested (scopes)
Note: The app requires the following scopes to be reviewed and approved by your Microsoft Entra admin. If the scopes are not approved by your Entra admin, you may see an error when trying to connect the app within ChatGPT.
Approval of scopes does not immediately make all actions available to users. Admins and owners must still review app actions in Workspace settings > Apps for the app. In Action control, admins can choose how the app's current actions are handled by allowing all actions, allowing only read actions, or selecting a custom set of actions.
If admins select Custom, they can also choose how actions added later are handled by selecting Enable all new actions, Only enable new read actions, or Disable new actions. If admins select Disable new actions, they must review and enable new actions before users can use them. After admins allow additional actions, users may need to reconnect the app to use them.
Microsoft apps permissions required
To enable integration between ChatGPT and Microsoft Outlook, Teams, and SharePoint, permissions must be granted within Microsoft Entra ID (formerly Azure AD) for each service.
Review and approve Microsoft permissions
For each enabled Microsoft app:
In ChatGPT, go to Admin → Apps and select Enabled.
Open the app’s overflow menu and select Manage app.
Select Microsoft permissions and review the actions and Microsoft Graph permissions shown.
Select Review permissions in Microsoft Entra, then sign in with a Microsoft Entra administrator account that can grant organization-wide consent.
Verify the organization and the ChatGPT / OpenAI, L.L.C. application, then select Accept to approve the selected request or Cancel to make no change.
Repeat this review for each enabled Microsoft app. The requested permission set can differ by app.
Microsoft permission approval is separate from workspace action settings and from an individual user’s connection. Approval does not enable actions or connect a user’s Microsoft account. If your organization does not want to approve a permission, keep every action that depends on it disabled. Some users may need to reconnect after permissions change.
offline_access
User.Read
Mail.Read
Mail.ReadWrite
Mail.Read.Shared
Mail.ReadWrite.Shared
Mail.Send
Mail.Send.Shared
MailboxSettings.Read
MailboxSettings.ReadWrite
People.Read
User.ReadBasic.All
Contacts.Read
Contacts.ReadWriteShared/delegated mailbox actions are supported via dedicated actions and scopes. You must provide the exact mailbox owner email (UPN) when accessing shared mailboxes.
Known limitations
Search precision follows Microsoft Graph indexing latency — very recent emails may take a short time to appear.
Some broad or long-running requests (for example, summarizing all emails over an extended period of time) may exceed service limits enforced by Microsoft. In these cases, ChatGPT may return an error.
Workaround: Narrowing the date range or breaking the request into smaller queries often resolves the issue.
Your workspace owner or admin may restrict which Outlook accounts you can connect, to an approved set of domains.
MailboxSettings.Readscope is required to provide answer in the user's timezone and reference mailbox categories.Outlook write actions are not available when using the app through Company Knowledge.
Attachments from messages in shared or delegated mailboxes can’t currently be retrieved. The
list_attachmentsandfetch_attachmentactions work only with messages in the signed-in user’s mailbox.
Outlook Calendar app
The Outlook Calendar app allows ChatGPT to read and search calendar events and availability using Microsoft Graph APIs. It can also look up people and—when actions are enabled—create and manage Outlook contacts and contact folders. Calendar event data remains read-only.
Learn more about connecting a new app.
Example use cases and prompts
Communication and writing
“Summarize my next three meetings, including attendees and locations.”
“Draft a message to reschedule my 2 pm sync with [name].”
Organization and productivity
“What is on my schedule this afternoon?”
“Find my sync with the design team.”
“Show meetings from yesterday between 1 pm and 5 pm.”
Analysis and reporting
“Create a table of meeting title, organizer, date/time, and attendees for meetings about [topic] in the next 7 days.”
Capabilities and Permissions
What it can do
Return event metadata such as title, start and end time, location, description, and attendees.
Filter calendar searches by date range, keywords, or participant names.
Read basic availability and scheduling information.
Read delegated or shared calendars, events, calendar views, permissions, and meeting-time suggestions.
Search relevant people, work or school directory users, and saved mailbox contacts.
List, retrieve, create, update, and delete Outlook contacts and contact folders when actions are enabled.
Permission requested (scope)
offline_access
User.Read
Calendars.Read
Calendars.ReadWrite
Calendars.ReadWrite.Shared
MailboxSettings.Read
Calendars.Read.Shared
People.Read
User.ReadBasic.All
Contacts.Read
Contacts.ReadWriteNote: shared/delegated calendar actions are supported via dedicated actions and scopes. Existing personal calendar behavior remains unchanged.
Known limitations
Calendar event data, including event descriptions, is read-only. Contact actions are available separately when enabled.
Search precision follows Microsoft Graph API, which is limited.
Your workspace owner or admin may restrict which Outlook accounts you can connect, to an approved set of domains.
MailboxSettings.Readscope is required to provide answers in the user's timezone.Outlook write actions are not available when using the app through Company Knowledge.