
Microsoft Work IQ: the official Microsoft 365 MCP server
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.
Microsoft does not document Claude Code. Users report the hosted address needs your own Entra app registration to sign in.
Known problems
- Open
Sign-in to the hosted address never starts
Workaround: Have an admin register a single-tenant Entra app with Work IQ permissions and admin consent, then use its client ID.
Since Oct 2026 · GitHub
- Open
The local version fails to list its tools
Since Feb 2026 · GitHub
- Closed
Plugin skills failed to load with Path not found errors
Reported Mar 2026 · GitHub
Not in Microsoft's docs. A user reports it works as a custom connector once an admin registers an Entra app for Claude.
Known problems
- Open
Sign-in fails because Claude has no app registered in your organization
Workaround: Add an Entra app with redirect https://claude.ai/api/mcp/auth_callback and admin consent; enter its client ID in the connector.
Since Oct 2026 · GitHub
Microsoft's docs give one-click VS Code install links that run the local version on your computer.
Known problems
- Open
The hosted address never shows a sign-in prompt and ends with an unauthorized error
Since Aug 2026 · GitHub
- Open
The local version says Authentication failed, and VS Code sign-in steps are not documented
Since May 2026 · GitHub
- Open
Does not remember your account and asks you to pick it again
Since Mar 2026 · GitHub
- Open
Asking questions stops working for the rest of the session after about 30 requests
Since Feb 2026 · GitHub
Microsoft's docs cover it: add the Work IQ plugin marketplace, install the plugin, restart and sign in.
Known problems
- Open
Says sign-in worked, then fails to reconnect because it still asks you to sign in
Since Oct 2026 · GitHub
- Open
The first message in a new chat often fails while it is still signing in
Workaround: Resend the same prompt a few seconds later.
Since Jul 2026 · GitHub
- Open
Disconnects after about an hour idle and needs a fresh sign-in
Workaround: Sign out and sign in again before each session.
Since Jun 2026 · GitHub
- Open
The local version hangs silently until you accept the license terms
Workaround: Run workiq accept-eula once before starting the server.
Since May 2026 · GitHub
- Open
The local version fails to connect with a Connection closed error
Since Feb 2026 · GitHub
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports hosted MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports hosted MCP servers.
Install Microsoft Work IQ MCP
Claude Code
- 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
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 ·
askSearches 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 ·
retrieveReads 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 ·
fetchDownloads 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_blobWorks 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_functionCreates 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_entityChanges 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_entityTakes 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_actionDeletes 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_entityLists 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_agentsUsed 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_pathsChecks 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
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
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-only | For 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 to | https://workiq.svc.cloud.microsoft/mcp. https://login.microsoftonline.com |
| Sign-in and keys | Microsoft Entra ID sign-in; every request runs as the signed-in user. |
| Data retention | Microsoft says Work IQ does not store your Microsoft 365 data; each tool call is logged for auditing, usage analytics, rate limiting and compliance. |
| Scopes |
|
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.
| Server | Official | Runs | Covers | Can change things | Tools | GitHub stars |
|---|---|---|---|---|---|---|
| For Microsoft 365 | ||||||
| Microsoft Work IQThis page | Official | HostedLocal | All Microsoft 365 | Yes | 12 | 1K |
| ms-365-mcp-server | Community | Local | Mail, calendar, files, Teams | – | – | 1.1K |
| Microsoft 365 Mail | Community | Local | Outlook mail | Yes | – | – |
| Microsoft 365 Calendar | Community | Local | Outlook calendar | Yes | – | – |
| Other tools for the same job | ||||||
| Work IQ Teams | Official | Hosted | Teams 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
“The same endpoint works from GitHub Copilot CLI with a plain `type: http` entry and no client ID configured, so the service itself appears to be fine. The question is how a client other than Copilot CLI is supposed to connect.”cveldGitHub issueOct 2026
“Copilot CLI works because it signs in through a client Microsoft already registered. Claude has no client in your tenant, so it tries to register one on the fly, Entra doesn't allow that, and you get "failed to log in."”jimmyblainGitHub issueJun 2026
“`workiq ask` consistently returns `403 (Forbidden)`, and `workiq fetch -u /me` returns `The caller is not entitled to use this tool.`”klittle32GitHub issueAug 2026
“Setting up the billing policy resolved my issue”davidhjones
4 more quotesFewer quotes
“WorkIQ disconnects/becomes unauthenticated approximately 60 minutes after the last interaction. Re-authenticating restores functionality.”thejohnjansenGitHub issueMar 2026
“However, my colleagues cannot use it at all. The error message they receive clearly states that they need to have a Microsoft Copilot license in order to use it.”doggy8088GitHub issueJun 2026
“This was previously working in my tenant. The entitlement gate failure started appearing without any known licensing or consent changes on my side.”Quinn87GitHub issueSep 2026
“The process ran unattended for approximately three days. Firefox eventually contained 914 windows and 1,147 tabs.”janmaarten-a11y
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?
SourceFind unread mail from one person
List my unread emails from Sarah this week
SourceSum up a Teams channel
Summarize today's messages in the Engineering channel
SourcePull requirements into a coding task
What authentication requirements did my team discuss for the customer portal? Check my meetings and emails.
SourceBook a meeting (needs changes turned on)
Create a calendar event Friday at 3pm with the design team
SourceReply 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 37Hide
- Microsoft Learn · learn.microsoft.com
- Microsoft Learn · learn.microsoft.com
- npm · npmjs.com
- GitHub · github.com
- Enable Work IQ · learn.microsoft.com
- Admin instructions · github.com
- Microsoft Learn · learn.microsoft.com
- Work IQ README · github.com
- GitHub · github.com
- Work IQ MCP overview · learn.microsoft.com
- Microsoft Work IQ · learn.microsoft.com
- Microsoft · microsoft.com
- Work IQ tool reference · learn.microsoft.com
- Work IQ permissions · learn.microsoft.com
- Work IQ plugin README · github.com
- GitHub · github.com
- GitHub · github.com
- Add Work IQ in Copilot Studio · learn.microsoft.com
- GitHub · github.com
- GitHub · github.com
- GitHub · github.com
- GitHub · github.com
- GitHub · github.com
- GitHub · github.com
- GitHub · github.com
- GitHub · github.com
- GitHub · github.com
- GitHub · github.com
- GitHub · github.com
- GitHub · github.com
- GitHub · github.com
- GitHub · github.com
- GitHub · github.com
- GitHub · github.com
- GitHub · github.com
- GitHub · github.com
- MCP Registry · registry.modelcontextprotocol.io