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

# Set Up Microsoft Teams

> Connect Microsoft Teams to Mavio for automatic meeting recording and transcription.

Connect Microsoft Teams so the Mavio bot joins your calls automatically and delivers transcriptions, summaries, and action items after every meeting.

## Prerequisites

Before you begin, make sure you have:

* A Mavio account on the **Pro** plan or higher
* Microsoft Teams with admin or meeting organizer permissions
* A Microsoft 365 business account (personal accounts are not supported)

<Warning>
  If your organization uses strict Teams policies, you may need your IT admin to approve the Mavio bot. See the [admin approval](#admin-approval) section below.
</Warning>

## Connect your Teams account

<Steps>
  <Step title="Open integration settings">
    Go to **Settings** > **Integrations** > **Microsoft Teams** in your Mavio dashboard, or navigate to [mavioapp.com/settings/integrations](https://mavioapp.com/settings/integrations).
  </Step>

  <Step title="Sign in with Microsoft">
    Click **Connect Microsoft Teams** and sign in with your Microsoft 365 account. Grant the requested permissions so Mavio can access your meeting calendar and join calls.
  </Step>

  <Step title="Configure auto-recording">
    Choose when the Mavio bot should join your meetings:

    * **All scheduled meetings** — joins every Teams meeting on your calendar
    * **Calendar-tagged meetings only** — joins meetings you tag with `[Mavio]` in the title or description
    * **Manual only** — the bot joins only when you explicitly invite it
  </Step>

  <Step title="Test with a sample meeting">
    Schedule a short Teams meeting and verify the Mavio bot joins, records, and delivers a transcript afterward.
  </Step>
</Steps>

## Bot behavior in Teams

When the Mavio bot joins a Teams meeting it:

1. Appears as **Mavio Notetaker** in the participant list
2. Sends a chat message notifying participants that the meeting is being recorded
3. Records audio for the duration of the meeting
4. Leaves automatically when the meeting ends or when all other participants leave

<Tip>
  You can customize the bot display name in **Settings** > **Integrations** > **Microsoft Teams** > **Bot Name**.
</Tip>

## Admin approval

If your Microsoft 365 tenant restricts third-party apps, an admin must approve Mavio:

<Steps>
  <Step title="Share the approval link">
    Send your IT admin the approval URL shown on the integration page. This opens the Microsoft Entra admin consent flow.
  </Step>

  <Step title="Admin grants consent">
    The admin reviews the requested permissions and clicks **Accept** to allow Mavio across the organization.
  </Step>

  <Step title="Retry connection">
    After admin approval, return to **Settings** > **Integrations** > **Microsoft Teams** and click **Connect** again.
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="What permissions does Mavio request?">
    Mavio requests `OnlineMeetings.Read`, `Calendars.Read`, and `User.Read` permissions. It does **not** request write access to your calendar or messages.
  </Accordion>

  <Accordion title="Can I use Mavio with Teams channels and group calls?">
    Yes. The Mavio bot can join any Teams meeting — scheduled, channel, or ad-hoc group calls — as long as the meeting organizer has connected their account.
  </Accordion>

  <Accordion title="Does Mavio work with Teams Webinars?">
    Teams Webinars are supported on **Team** and **Enterprise** plans. The bot joins as an attendee and records the full session.
  </Accordion>

  <Accordion title="How do I stop the bot from joining a specific meeting?">
    Add `[no-record]` to the meeting title or description, or remove the meeting from your Mavio auto-record rules.
  </Accordion>

  <Accordion title="Why is the bot not joining my meeting?">
    Check that your Teams tenant allows external bots, that your Mavio plan supports bot recording, and that the meeting wasn't created by a user who hasn't connected Mavio. See [Troubleshooting: Bot not joining](/documentation/troubleshooting/bot-not-joining) for more help.
  </Accordion>
</AccordionGroup>