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

# Microsoft 365 connector

> Connect SharePoint, OneDrive, Outlook, and Teams to Claude so it can search, analyze, and act on your Microsoft 365 information

The Microsoft 365 connector lets Claude search, analyze, and act on information across SharePoint, OneDrive, Outlook, and Teams, using the access your own Microsoft 365 account already has. It's available on every Claude plan: Free, Pro, Max, Ultra, Team, and Enterprise. Each kind of Microsoft account has its own requirements:

* **Work or school account**: a Microsoft Entra Global Administrator must grant tenant consent for your Microsoft organization
* **Personal account**: on Free, Pro, Max, and Ultra plans, you can connect a personal Microsoft account, such as an Outlook.com, Hotmail, Live, or MSN account. It connects Outlook and OneDrive, and you don't need an administrator to set it up. Team and Enterprise plans support work or school accounts only.

By the end of this page you have the connector set up and your own account connected, and you have asked Claude a first question that draws on Microsoft 365.

> [!NOTE]
>
> * If your organization runs Claude Desktop on third-party inference, see [Connect to Microsoft 365](https://claude.com/docs/third-party/claude-desktop/connectors-m365.md) instead
> * If you're in a US government deployment, see [Set up the Microsoft 365 connector](https://claude.com/docs/government/connectors/microsoft-365.md) in the government section

## Review what Claude can do

All access is delegated: Claude acts on your behalf and can read or change only what your Microsoft 365 account can already read or change.

### What Claude can do with a work or school Microsoft account

The table lists what Claude can do in each service with a work or school account. The write column applies only when your administrators have turned on [write actions](#write-actions).

| Service | Read and search | Write |
| - | - | - |
| **SharePoint and OneDrive** | Search and analyze documents across SharePoint sites and OneDrive libraries | Create and update files in OneDrive and SharePoint |
| **Outlook** | Search email threads and archived email | Send mail and manage drafts, labels, mail filters, and automatic replies; create, update, and delete calendar events and find meeting times |
| **Teams Calendar** | Review meeting information, summaries, and attendance | None |
| **Teams Chat** | Read channel and chat discussions | Send chat and channel messages |

### What Claude can do with a personal Microsoft account

On Free, Pro, Max, and Ultra plans, you can connect a personal Microsoft account. The table lists what Claude can do in each service with a personal account.

| Service | Read and search | Write |
| - | - | - |
| **OneDrive** | Search your own OneDrive, including shared items you've added to it | Create and update files |
| **Outlook** | Search your email and calendar | Draft and send email, and manage calendar events |

A personal account doesn't include SharePoint, Teams, meeting summaries, mail filters, automatic replies, shared mailboxes or calendars, or finding times when other people are free. For what a personal account includes, see [Connect to Microsoft 365](https://support.claude.com/en/articles/15183774-connect-to-microsoft-365) in the help center.

## Set up the connector

What you do first depends on your Claude plan:

* **Free, Pro, Max, and Ultra**: there's no organization-level step in Claude. Skip to [Connect your account](#connect-your-account). For a work or school account, a Microsoft Entra Global Administrator still needs to grant tenant consent for your Microsoft organization.
* **Team and Enterprise**: a Claude Owner or Primary Owner [adds the connector for the organization](#add-the-connector-for-your-organization) first, and then each member connects their account

### Prerequisites

For a work or school account, check these before you start:

* An account on a Microsoft Entra tenant
* Global Administrator access to the Microsoft Entra tenant
* On Team and Enterprise plans: the Owner or Primary Owner role in Claude, and active Microsoft 365 accounts for all users

On Free, Pro, Max, and Ultra plans, you don't need any of these to connect a personal Microsoft account.

### Add the connector for your organization

On Team and Enterprise plans, an Owner or Primary Owner adds the connector once for everyone. The steps below are the automatic setup, which is the recommended path.

**1. Open organization connectors**

In claude.ai, go to [**Organization settings > Connectors**](https://claude.ai/admin-settings/connectors).

**2. Add Microsoft 365**

Select **Add**, then **All available**. Find **Microsoft 365** and select **Add to your team**.

**3. Connect and grant consent**

Connect your own account and grant the organization-wide permissions.

**4. Adjust access if needed**

Restrict which users can use the connector, or revoke specific permission scopes.

For the detailed administrator walkthrough, see [Set up the Microsoft 365 connector](https://support.claude.com/en/articles/12542951-set-up-the-microsoft-365-connector) in the help center. The [Microsoft 365 connector security guide](https://support.claude.com/en/articles/12684923-microsoft-365-connector-security-guide) covers the permission model.

### Connect your account

Once the connector is available to you, connect your own Microsoft 365 account. To connect a personal Microsoft account on a Free, Pro, Max, or Ultra plan, use Claude on the web. Once you've connected Microsoft 365, you can also use it in Claude for iOS and Claude for Android.

**1. Open your connectors**

Go to [**Customize > Connectors**](https://claude.ai/customize/connectors) in claude.ai. **Customize** is the page that holds your connectors, skills, and plugins.

**2. Connect Microsoft 365**

Find **Microsoft 365** and select **Connect**.

**3. Sign in to Microsoft**

If you're asked which account to connect, select the option that matches your account, **Personal account** or **Work or school account**. Sign in with that account when prompted.

When the connection succeeds, the **Connect** button on the Microsoft 365 connector changes to **Disconnect**. For the member walkthrough, see [Connect to Microsoft 365](https://support.claude.com/en/articles/15183774-connect-to-microsoft-365) in the help center.

## Try the connector

In a conversation, select **+** at the lower left of the message box, select **Connectors**, and turn on **Microsoft 365**. Then ask a question that needs Microsoft 365 data, or ask Claude to take an action such as sending an email or updating a file. Claude detects which tools it needs and uses them. For example, ask Claude:

* Find the Q4 strategic planning document in SharePoint
* Summarize email conversations about the product launch
* What discussions happened in Teams about the marketing campaign?
* Draft a reply to the latest email about the vendor contract
* Schedule a 30-minute sync with the design team next week

Examples that name SharePoint or Teams need a work or school account.

Claude's answer draws on the Microsoft 365 content it found. Requests that change something, such as the last two examples, need [write actions](#write-actions). With a work or school account, your administrators control them. Without write actions, Claude can still read and search.

## Write actions

Claude can take actions in Outlook, OneDrive, SharePoint, and Teams, as listed in the write columns of [Review what Claude can do](#review-what-claude-can-do). Read and search tools work the same whether or not write actions are enabled. Claude can't attach files to the drafts it creates.

Write actions are available in these ways:

* **Work or school account**: your organization's administrators control write actions in the connector's permissions in Microsoft Entra and in the Microsoft 365 connector configuration under **Organization settings > Connectors**
* **Personal account**: write actions in Outlook and OneDrive are available once you connect

### Approve the write permissions

If your tenant approved the connector before a write permission (mail, calendar, mailbox settings, file writes, or Teams messages) was added, a Microsoft Entra Global Administrator or Application Administrator approves the added permissions once for the tenant. Reconnecting doesn't add them. See [Approve permissions added to the connector](#approve-permissions-added-to-the-connector).

### Turn on write actions

If write actions are off for your organization, administrators turn them on for all users in the Microsoft 365 connector configuration, or enable them for specific users with role-based access control (beta). Administrators also check the restriction on each tool that sends Teams messages. A per-tool restriction overrides the **Default restriction** row, so a tool that is blocked for all users stays unavailable until an administrator changes its restriction. To let users choose those tools:

**1. Open the connector's configuration**

Open the Microsoft 365 connector under **Organization settings > Connectors**.

**2. Find Tool permission restrictions**

Find **Tool permission restrictions**.

**3. Allow each Teams messaging tool**

Set each Teams messaging tool so that users can choose it.

## Permissions

All permissions are delegated: Claude acts on behalf of users and can only access and change content that you already have permission to access and change in Microsoft 365. For a work or school account, your administrators control write actions, as described in [Write actions](#write-actions).

### Approve permissions added to the connector

If your tenant approved the connector before Anthropic added a permission to it, the Claude feature that needs the permission fails with a permission error until a Microsoft Entra administrator approves it. For example, listing your teams fails until your tenant approves `Team.ReadBasic.All`. Disconnecting and reconnecting the connector in claude.ai doesn't add the permission, because Microsoft [doesn't show a consent screen again once the tenant has approved the connector](https://learn.microsoft.com/en-us/entra/identity-platform/scopes-oidc#the-default-scope). The connector's **Permissions** page in the Entra admin center (under **Enterprise applications**, listed as **M365 MCP Server for Claude**) shows only the permissions your tenant has already approved, so a missing permission doesn't appear there.

A Global Administrator or Application Administrator approves the added permissions for the whole tenant by opening the admin consent link and accepting the list it shows.

**1. Open the admin consent link**

Replace `YOUR_TENANT_ID` with the Directory (tenant) ID shown in **Entra admin center > Overview**, then open the link. The `client_id` value is the connector's Application ID, shown on the **M365 MCP Server for Claude** enterprise application's **Overview** page.

```text theme={null}
https://login.microsoftonline.com/YOUR_TENANT_ID/adminconsent?client_id=07c030f6-5743-41b7-ba00-0a6e85f37c17
```

**2. Review the permissions and accept**

The consent screen lists every permission the connector requests, including any added since your tenant first approved it and the permissions that write actions need. The Teams tools use `Team.ReadBasic.All` to list teams, `People.Read` to look up people, and `ChatMessage.Send`, `ChannelMessage.Send`, and `Chat.Create` to send messages. Select **Accept**.

**3. Confirm the approval**

Check the address bar of the page Microsoft sends you to. The approval succeeded when the address contains `admin_consent=True`, and the approved permissions then appear on the connector's **Permissions** page.

Selecting **Grant admin consent for \{your organization}** on the connector's **Permissions** page in the Entra admin center approves the same list as the admin consent link.

The admin consent link is for the connector used from claude.ai. If the Application ID on the enterprise application's **Overview** page differs from the one in the link (for example in a government deployment), use that ID instead. The Claude Desktop local connector uses its own app registration.

## Troubleshooting

If something isn't working, start with the case that matches what you see.

> [accordion] Authentication failures
>
> If sign-in fails, work through these checks:
>
> * Confirm you chose the option that matches your account, **Personal account** or **Work or school account**. Each option accepts only that kind of account.
> * If you have a work or school account and weren't asked which account to connect, confirm you're signing in with that account. Team and Enterprise plans support work or school accounts only.
> * On Free, Pro, Max, and Ultra plans, if you have a personal Microsoft account and weren't asked which account to connect, make sure you're using Claude on the web. Microsoft 365 may also already be connected. To switch between a work or school account and a personal account, go to [**Customize > Connectors**](https://claude.ai/customize/connectors), select **Disconnect** on **Microsoft 365**, and connect again.
> * For a work or school account, also check that your Microsoft 365 license is active and review your organization's third-party app policies
> * Try a different browser, or clear cookies and cache and sign in again

> [accordion] Documents not found
>
> If Claude can't find a document you know exists:
>
> * Confirm you can open the document directly in Microsoft 365
> * Make sure the document is stored in SharePoint or OneDrive, not only on your computer
> * Wait and retry for recently uploaded documents, which can take time to index
> * Search by the exact filename
> * With a work or school account, name the specific SharePoint site

> [accordion] Incomplete search results
>
> If results are partial or miss what you expected:
>
> * Be more specific about what you need
> * Specify locations and date ranges
> * Use exact phrases from the content
> * Break a complex request into simpler questions

## Next steps

* [Add a connector from the directory](https://claude.com/docs/connectors/getting-started.md#add-a-connector-from-the-directory): find a connector for another service in the directory and connect it
* [Connectors directory](https://claude.com/docs/connectors/directory.md): browse verified and community integrations
