PlugWiki
Microsoft Work IQ logo

Microsoft Work IQ: the official Microsoft 365 MCP server

OfficialRemoteLocal
Gethttps://workiq.svc.cloud.microsoft/mcpmicrosoft/work-iqDocs

Lets GitHub Copilot, VS Code and other AI apps read and act on your Microsoft 365 mail, calendar, files and Teams, after your IT admin approves it.

Work IQ is Microsoft's official way to let an AI assistant work with your Microsoft 365 mail, calendar, OneDrive and SharePoint files, and Teams chats. You can ask it to find a thread, sum up a meeting or a channel, or pull what your team said about a project, and with your admin's approval it can also send mail and book meetings. Before you start, know that an IT admin has to approve it for your organization and set up Copilot Credits billing, because each request is charged. Microsoft Learn says you do not need a Microsoft 365 Copilot licence, but the admin guide in Microsoft's Work IQ GitHub repo still lists one for each user.

Good for

  • People at companies on Microsoft 365 who want their AI assistant to search their mail, meetings, files and Teams chats
  • Developers using GitHub Copilot CLI or VS Code who want meeting notes and email context while they code
  • IT admins deciding whether to let AI tools reach company Microsoft 365 data
  • Teams already paying for Copilot Credits or Copilot Studio

Works in

4 with issues · 10 should work

Tap an app to see how to set it up and any known problems.

Install Microsoft Work IQ MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the Microsoft Work IQ MCP server to Claude Code. Run this command:
    
    claude mcp add microsoft-work-iq -- npx -y @microsoft/workiq mcp
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js, Microsoft 365 work or school account, Admin consent for Work IQ in your organization, Copilot Credits billing (a Microsoft guide also lists a Copilot licence).

Read-only mode: Changes such as sending mail stay blocked until your admin turns them on in the Microsoft 365 admin center, under Agents, Tools, Work IQ MCP. Leave them off for read-only use.

Before the local version's first run, accept Microsoft's license terms once with workiq accept-eula (install the CLI with npm install -g @microsoft/workiq), or it waits silently.

Microsoft does not document this app. People report the hosted address fails to sign in from apps other than GitHub Copilot CLI unless an admin registers a separate Entra app and you enter its client ID (report). The local version signs in through its own Microsoft sign-in instead.

An admin must first turn Work IQ on for your organization and grant consent; see Microsoft's admin setup.

Built from the package data we hold. Not yet tested by us.

Tools

  • Asks Microsoft 365 Copilot a question about your mail, meetings, files and chats

    Sends your question to Microsoft 365 Copilot, which answers from the mail, meetings, files and chats you can access. It can also send the question to one of your organization's Copilot agents instead.

    Try: “What did my team decide about the launch date in last week's meetings?”

    Read · ask

  • Searches your Microsoft 365 content and returns passages with links to the sources

    Searches your Microsoft 365 data and any company sources connected to it, and returns relevant passages with a citation for each one. Microsoft still lists this tool as a preview.

    Try: “Find what our documents say about the travel expense policy and link the sources”

    Read · retrieve

  • Reads your emails, events, files, chats or contacts

    Reads items from your Microsoft 365 account, such as messages, calendar events, files, Teams chats or people, and can read several at once.

    Try: “List my unread emails from Sarah this week”

    Read · fetch

  • Downloads the contents of a file, image or Office document

    Downloads the actual contents of a file from OneDrive, SharePoint or an attachment so the assistant can read it. Files over 4 MB are refused by default.

    Try: “Open the Q3 budget spreadsheet in my OneDrive and summarize it”

    Read · fetch_blob

  • Works out things like free time, recent changes or search results

    Runs a Microsoft 365 calculation that returns new information, such as when people are free, what changed since a point in time, or search results.

    Try: “When are Priya and I both free for an hour next Tuesday?”

    Read · call_function

  • Creates something new, like a calendar event, draft email or contact

    Creates a new item in your Microsoft 365 account, such as a meeting, a draft message or a contact. It only works once your admin allows changes.

    Try: “Create a calendar event Friday at 3pm with the design team”

    Write · create_entity

  • Changes an existing item, like moving a meeting or editing a draft

    Edits an item that already exists in your account, for example changing a meeting time or updating a draft. It only works once your admin allows changes.

    Try: “Move my 1:1 with Alex on Thursday to 4pm”

    Write · update_entity

  • Takes actions such as sending an email, accepting a meeting or moving a file

    Carries out an action with an effect others can see, such as sending an email, replying to an invite, or copying and moving items. Microsoft warns these run right away and may not be reversible.

    Try: “Accept the 2pm meeting from Rob”

    Write · do_action

  • Deletes an item, such as an email, event or file

    Removes an item from your Microsoft 365 account. One user reports deleted mail skips the Deleted Items folder, so check before you approve.

    Try: “Delete the duplicate 'Team sync' event on Monday”

    Delete · delete_entity

  • Lists the Copilot agents your questions can be sent to

    Shows the Copilot agents available in your organization that the assistant can send questions to. The built-in Microsoft 365 Copilot is always on the list.

    Try: “Which Copilot agents can I ask through Work IQ?”

    Read · list_agents

  • Used by the assistant behind the scenes

    Looks up which kinds of Microsoft 365 data it can reach

    Lets the assistant look up which Microsoft 365 data locations are available before it reads or changes anything. You rarely ask for this yourself.

    Try: “What kinds of Teams data can you read?”

    Read · search_paths

  • Checks the exact format a request needs before sending it

    Lets the assistant check which fields a request needs, such as what a new calendar event must include, before it calls another tool.

    Try: “What fields do you need to create a meeting?”

    Read · get_schema

From the official docs

Pros and cons

Good

  • Built and run by Microsoft, with a hosted address that GitHub Copilot CLI reaches through Microsoft's plugin
  • One connection covers Outlook mail, calendar, OneDrive, SharePoint, Teams and Microsoft 365 Copilot
  • Changes such as sending mail stay blocked until an admin turns them on
  • Uses your existing Microsoft 365 permissions, so it only sees what you can see
  • Microsoft's licensing page says there is no separate Work IQ licence; you pay per request in Copilot Credits

Watch out

  • Needs an IT admin to approve it for the whole organization before anyone can sign in
  • Needs a Copilot Studio usage billing plan with an Azure subscription; each tool call costs 0.1 Copilot Credits
  • Microsoft's pages disagree on whether each user also needs a Microsoft 365 Copilot licence
  • Only GitHub Copilot CLI, VS Code, Foundry and Copilot Studio are documented; Claude needs an extra app registration
  • Many open reports of sign-in loops, dropped sessions and 'not entitled' errors
  • Reads return at most 100 items and file downloads stop at 4 MB

Permissions

high risk · 6 things to watch

High risk

Once your admin turns on changes, your assistant can send email, accept meetings and delete items as you, and Microsoft warns these run right away and may not be reversible. Leave changes switched off in the Microsoft 365 admin center unless you need them, and check each action before you approve it.

What it can do

Watch out for

  • It can send mail and delete items as you

    With changes turned on, it can send email, accept meetings and delete items. Keep changes off unless you need them, and read each action before you approve it. github.com

  • One admin approval covers your whole company

    The quick admin consent link grants access for everyone in the organization. Admins should decide on that before clicking it, since every user can then connect. github.com

  • Deleted mail skips Deleted Items

    A user reports mail deleted through it does not land in Deleted Items. Recovery then needs the Recoverable Items folder, so be careful with delete requests. github.com

  • Every request is logged and billed

    Each tool call is logged for audit and charged 0.1 Copilot Credits. Long agent sessions can add up, so watch usage in Copilot Studio. microsoft.com

  • A sign-in loop once opened hundreds of windows

    On macOS, one version kept opening Microsoft sign-in windows for days. The report is closed; update to the latest version. github.com

  • Change defaults differ by Microsoft product

    Work IQ MCP blocks changes by default, but Copilot Studio says changes are on by default there. Check the policy in the Microsoft 365 admin center. learn.microsoft.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Turning on read-onlyFor Work IQ MCP, tenant policy blocks create, update, delete and send actions by default until an admin enables them in Microsoft 365 admin center > Agents > Tools > Work IQ MCP (changes take up to 24 hours). You can also limit the client's tools list to read tools such as fetch, ask, retrieve, search_paths and get_schema.
Talks tohttps://workiq.svc.cloud.microsoft/mcp. https://login.microsoftonline.com
Sign-in and keysMicrosoft Entra ID sign-in; every request runs as the signed-in user.
Data retentionMicrosoft says Work IQ does not store your Microsoft 365 data; each tool call is logged for auditing, usage analytics, rate limiting and compliance.
Scopes
  • WorkIQ.Read: read Microsoft 365 data the signed-in user can access (admin consent required)

  • WorkIQ.Act: create, update, delete and actions such as sending mail (admin consent required)

  • WorkIQAgent.Ask: ask Microsoft 365 Copilot or a Copilot agent (admin consent required)

Alternatives

Use Work IQ if your company already pays for Copilot Credits and your admin will approve it, since it is Microsoft's own path to all of Microsoft 365. If you cannot get admin approval or want a single app like Outlook mail, a community server for Microsoft 365 is the simpler pick.

ServerOfficialRunsCoversCan change thingsToolsGitHub stars
For Microsoft 365
Microsoft Work IQThis pageOfficialHostedLocalAll Microsoft 365Yes121K
ms-365-mcp-serverCommunityLocalMail, calendar, files, Teams––1.1K
Microsoft 365 MailCommunityLocalOutlook mailYes––
Microsoft 365 CalendarCommunityLocalOutlook calendarYes––
Other tools for the same job
Work IQ TeamsOfficialHostedTeams only–––

What people say

People like having one connection for all of Microsoft 365, and dislike how hard it is to get signed in and approved.

What people like

  • One connection covers mail, calendar, files, Teams and Microsoft 365 Copilot itself
  • Works from GitHub Copilot CLI with a plain web address and no app to register
  • Every request runs as you and sees only what your account can already see

Common complaints

  • Claude and other non-Microsoft apps cannot sign in until an admin registers a separate app
  • Many organizations hit 'not entitled' errors after setup; several fixed it by turning on Copilot Credits billing
  • Sign-in is fragile: repeated prompts, accounts not remembered, and drops after an hour idle
  • Whether you need a Microsoft 365 Copilot licence is confusing, and colleagues without one were blocked in one report
  • Asking it questions in bulk was slow and often timed out in one user's test
  • Deleting mail through it skips Deleted Items, so a mistake is harder to undo

In their words

4 more quotes

Questions

Is there a Microsoft 365 MCP server?

Yes. Work IQ is Microsoft's official one, covering Outlook mail, calendar, OneDrive and SharePoint files, Teams and Microsoft 365 Copilot. Community servers also exist if your admin will not approve Work IQ.

Do I need a Microsoft 365 Copilot licence to use Work IQ?

Microsoft's own pages disagree. Microsoft Learn says Work IQ works without a Microsoft 365 Copilot licence and is billed per use in Copilot Credits, and Microsoft's licensing page says there is no separate Work IQ licence. The admin guide in Microsoft's Work IQ GitHub repo still lists a Copilot licence for each user, and one user's colleagues were told they needed one, so check with your admin before you roll it out.

Does my IT admin have to approve Work IQ?

Yes. Every Work IQ permission needs admin consent, and a Global Administrator must turn it on once for the organization. Consent can come from a Global, Privileged Role, Cloud Application or Application Administrator; anyone else sees a request-approval screen.

What is the Work IQ MCP server URL?

https://workiq.svc.cloud.microsoft/mcp. You sign in with your Microsoft work account. There is also a local version you run with npm, shown in the install box above.

Can Work IQ send email or delete things?

Yes, once your admin allows it. It can send mail, create and accept meetings, move items and delete them. For Work IQ MCP these changes are blocked by default until an admin turns them on in the Microsoft 365 admin center.

Does Work IQ work with Claude?

Not out of the box. Microsoft does not document Claude, and people report sign-in fails because Claude has no app registered in your organization. One user's fix is an admin-registered Entra app whose client ID you enter in Claude's custom connector.

Why do I get 'The caller is not entitled to use this tool'?

Often it is billing. Several users fixed it by setting up the Copilot Credits billing policy, and Microsoft says each user must be assigned to that billing plan. In one report, colleagues without a Microsoft 365 Copilot licence were blocked, so ask your admin about licences too.

How much does Work IQ cost?

About 0.1 Copilot Credits per tool call. Microsoft sells no separate Work IQ subscription; your company pays for Copilot Credits through Copilot Studio. Whether users also need a Microsoft 365 Copilot licence is unclear, since Microsoft's pages disagree (see the licence question above).

Is Work IQ still in preview?

No. Microsoft says it became generally available on June 16, 2026, and older preview versions are no longer supported. The search-with-citations feature is still in preview.

Why does sign-in fail on Linux?

Users report the built-in sign-in helper fails on Linux and in containers. A reported fix is running workiq config set disableBrokeredAuth=true, then signing in again.

Examples

  • Catch up on what a colleague said

    What did John say about the proposal?

    Source
  • Find unread mail from one person

    List my unread emails from Sarah this week

    Source
  • Sum up a Teams channel

    Summarize today's messages in the Engineering channel

    Source
  • Pull requirements into a coding task

    What authentication requirements did my team discuss for the customer portal? Check my meetings and emails.

    Source
  • Book a meeting (needs changes turned on)

    Create a calendar event Friday at 3pm with the design team

    Source
  • Reply to a meeting invite (needs changes turned on)

    Accept the 2pm meeting from Rob

    Source

Information

updated Nov 2, 2026

Publisher
Official
Package
@microsoft/workiq
Registry
npm
Endpoint
https://workiq.svc.cloud.microsoft/mcp
Transport
stdio, Streamable HTTP
Auth
OAuth
Version
1.0.1
License
SEE EULA
Last commit
Oct 30, 2026
Open issues
98

WebsiteWork IQ MCP overviewGitHubnpmCopilot CLI quickstartPricingPermissionsIssues

Other Microsoft 365 MCP servers

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 37
  1. Microsoft Learn · learn.microsoft.com
  2. Microsoft Learn · learn.microsoft.com
  3. npm · npmjs.com
  4. GitHub · github.com
  5. Enable Work IQ · learn.microsoft.com
  6. Admin instructions · github.com
  7. Microsoft Learn · learn.microsoft.com
  8. Work IQ README · github.com
  9. GitHub · github.com
  10. Work IQ MCP overview · learn.microsoft.com
  11. Microsoft Work IQ · learn.microsoft.com
  12. Microsoft · microsoft.com
  13. Work IQ tool reference · learn.microsoft.com
  14. Work IQ permissions · learn.microsoft.com
  15. Work IQ plugin README · github.com
  16. GitHub · github.com
  17. GitHub · github.com
  18. Add Work IQ in Copilot Studio · learn.microsoft.com
  19. GitHub · github.com
  20. GitHub · github.com
  21. GitHub · github.com
  22. GitHub · github.com
  23. GitHub · github.com
  24. GitHub · github.com
  25. GitHub · github.com
  26. GitHub · github.com
  27. GitHub · github.com
  28. GitHub · github.com
  29. GitHub · github.com
  30. GitHub · github.com
  31. GitHub · github.com
  32. GitHub · github.com
  33. GitHub · github.com
  34. GitHub · github.com
  35. GitHub · github.com
  36. GitHub · github.com
  37. MCP Registry · registry.modelcontextprotocol.io

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.