> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tess.im/llms.txt
> Use this file to discover all available pages before exploring further.

# Outlook

> Connect Outlook to Tess to work with email and calendar context from Microsoft accounts in chat and agents.

The **Outlook** connector integrates Tess with Microsoft Outlook. Once connected, the AI can help with mailbox and calendar tasks inside chats and agents, using the permissions of the connected Microsoft account.

Outlook is part of the Tess [Connectors](/en/connectors) ecosystem and uses **OAuth** authentication for Apps connectors.

## Prerequisites

<Info>
  * A Microsoft account with Outlook mail/calendar access.
  * Permission to authorize the Outlook/Microsoft OAuth app.
</Info>

## How to connect

<Tip>
  On some Apps connectors, the OAuth consent screen may show a third-party connection bridge name rather than Tess. That is normal—review the requested permissions and continue if they match what you expect.
</Tip>

<Steps>
  <Step title="Open the Connectors panel">
    In chat, click the **+** next to the message box and select **Connectors**.
    You can also manage connectors while editing an agent in Agent Studio.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/tess-dfe1edf0/images/connectors/outlook/01-connect-panel.png" alt="PRINT: (Connectors panel with Outlook highlighted and the Connect button visible)" />
    </Frame>
  </Step>

  <Step title="Find Outlook and click Connect">
    Under **Apps**, locate **Outlook** and click **Connect** to start authentication.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/tess-dfe1edf0/images/connectors/outlook/02-oauth-consent.png" alt="PRINT: (Provider authorization / consent screen for Outlook)" />
    </Frame>
  </Step>

  <Step title="Authorize access">
    Sign in with the account you want to use and review the requested permissions before confirming.
  </Step>

  <Step title="Confirm it is active">
    Back in Tess, **Outlook** should appear under **Connected**, ready for chats and agents.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/tess-dfe1edf0/images/connectors/outlook/03-connected.png" alt="PRINT: (Tess callback or Connectors list showing Outlook as Connected with a success state)" />
    </Frame>
  </Step>
</Steps>

## What you can do

* **Search and summarize emails** from the connected mailbox
* **Draft and send messages** when send permissions are available
* **Check calendar availability** and upcoming events
* **Support inbox triage** with priorities and suggested replies
* **Keep Microsoft productivity work inside Tess**

## Example prompts

> 1. Find unread emails from Contoso about renewal and summarize next steps.
> 2. What does my Outlook calendar look like tomorrow morning?
> 3. Draft a reply to the latest email from Ana about the proposal and show it before sending.
> 4. List meetings this week that conflict with a 1-hour focus block.

## Best practices

* Say whether you mean mail, calendar, or both.
* Ask for a draft before sending external emails.
* In agents, define the Outlook role clearly (triage, scheduling, or both).

## Troubleshooting

<AccordionGroup>
  <Accordion icon="circle-question" title="Admin consent required">
    Some Microsoft tenants require an admin to approve the app before users can connect.
  </Accordion>

  <Accordion icon="circle-question" title="401 / connection dropped">
    Reconnect Outlook in Connectors after password, MFA, or policy changes.
  </Accordion>

  <Accordion icon="circle-question" title="Mailbox or calendar missing data">
    Confirm the connected account can access that mailbox/calendar in Outlook.
  </Accordion>
</AccordionGroup>

<Note>
  Tess uses the permissions of the connected account. It does not expand access beyond what that account can already do.

  Connectors involve access to external systems. Only connect accounts that fit the usage context, and review permissions carefully.
</Note>