← MCP directory

Microsoft 365 MCP server

beta

Microsoft exposes Microsoft 365 through Work IQ MCP, a hosted server with a single address for mail, calendar, Teams, OneDrive and SharePoint and Entra ID sign-in. Changes are blocked until an admin allows them in the Microsoft 365 admin center, and use is paid for with Copilot Credits.

What an agent can do

  • → Read mail, calendar and Teams chats
  • → Find documents in OneDrive and SharePoint
  • → Ask Microsoft 365 Copilot
  • → Retrieve source material with citations
  • → Create and send, if the admin allows it

Needs a Global Administrator to enable Work IQ once and usage-based billing with Copilot Credits to be set up. The retrieve tool is in public preview.

About the Microsoft 365 MCP server

Work IQ MCP is Microsoft's own remote server for Microsoft 365. It lives at workiq.svc.cloud.microsoft/mcp and gives AI agents tools to read, create, update and delete Microsoft 365 content, ask Microsoft 365 Copilot questions and retrieve source material. Everything goes through a single address. The server has a small set of generic tools that work on resource paths, so new services are added as paths and not as new tools.

Teams use it to let an assistant read mail and calendars, find documents in OneDrive and SharePoint, read messages in Teams chats and answer questions that draw on several sources at once, such as which meetings are on today or what has been said about a project's risks. If the administrator has allowed changes, the assistant can also create calendar events, write drafts and send email.

Access is layered. Sign-in goes through Microsoft Entra ID on behalf of the signed-in user, and the server only reaches what that person can already access. On top of that, every request is checked against the organisation's policy. By default all changes are blocked, including sending email, until an administrator allows them in the Microsoft 365 admin center. The policy applies to the whole organisation and, in the initial release, cannot be set per user or per app.

Things to ask

  • Which meetings do I have today, and which of them have no agenda?
  • Summarise this week's unread emails from customers.
  • Find the latest document about the launch plan in SharePoint and list the risks it mentions.
  • What has been said in the Teams chat with the sales team about the price change?
  • Create a draft reply to the latest email from our auditor.

Tools the server exposes

  • fetch
  • fetch_blob
  • create_entity
  • update_entity
  • delete_entity
  • do_action
  • call_function
  • ask
  • retrieve
  • list_agents
  • get_schema
  • search_paths

How to connect Microsoft 365

  1. Set up usage-based billing with Copilot Credits in Copilot Studio, with an Azure subscription and resource group.
  2. Have a Global Administrator enable Work IQ for the organisation. It is done once and, according to Microsoft, takes about five minutes.
  3. Add the server https://workiq.svc.cloud.microsoft/mcp in your AI client and sign in with your work account through Microsoft Entra ID. The permissions require admin consent.
  4. If the assistant should create, change or send anything, an administrator allows it in the Microsoft 365 admin center under Agents, Tools and Work IQ MCP. The change can take up to 24 hours to apply.

Part of these packages

Microsoft 365 is part of these Walma packages.

Questions about Microsoft 365 MCP

Is Work IQ MCP free, and which licence is required?+

No. Microsoft writes that the Work IQ API is paid per use with Copilot Credits and is covered by your agreement for Microsoft Online Services. The stated prerequisite is a usage-based billing plan in Copilot Studio with an Azure subscription. Without billing enabled, the service answers with a 403 Forbidden error.

What is the URL of Microsoft's MCP server for Microsoft 365?+

https://workiq.svc.cloud.microsoft/mcp. It is a remote server that Microsoft hosts, and all tools are reached through that single address. Microsoft also has a local variant: the Work IQ CLI command-line tool, which can be started as a local MCP server for development environments.

How does sign-in work?+

With Microsoft Entra ID and delegated sign-in, meaning on behalf of the signed-in user. The client discovers the sign-in configuration from the server automatically. Application-only authentication is not supported. The three permissions WorkIQ.Read, WorkIQ.Act and WorkIQAgent.Ask all require admin consent.

Is it read-only?+

In practice yes, until an administrator decides otherwise. The server has tools to create, update, delete and perform actions, but the organisation's policy blocks all changes by default, including sending email. An administrator can allow them in the Microsoft 365 admin center. Even then, the user's own permissions still apply.

Which AI assistants does it work with?+

Microsoft describes the MCP route as intended for IDEs, command-line tools and AI coding assistants, and has a dedicated quickstart for Microsoft Foundry. The local variant, the Work IQ CLI, has install links for VS Code. On the pages read here, Microsoft does not state a full list of other assistants.

Who can turn on Work IQ MCP in our organisation?+

The initial Work IQ setup is done once by a Global Administrator. The MCP policy is then managed in the Microsoft 365 admin center under Agents, Tools and Work IQ MCP, by an account with permission to manage Work IQ or Copilot settings. A policy change can take up to 24 hours to apply across the organisation.

Are there limits on how much data is fetched?+

Yes. Lists return 25 items by default and at most 100 per request, and chat messages at most 10 per request. Files are fetched up to 4 MB by default. The server does not retry on its own, so on a 429 error it is the client that has to wait and try again. The retrieve tool is in public preview.

Missing a connection?

We build and review MCP servers for teams that need them, and run them behind the same policy and log as the rest of the gateway.