← Back to directory
M

Microsoft Work IQ

Official
Query Microsoft 365 work information in natural language.
Category
Collaboration #34 of 55
Stars
★ 1.0k Very popular
Transport
stdio (local process)
Runtime
Node.js 18+
Credentials
API key / credential required
License
Other / unspecified
Last commit
51FMRS · D

An official Microsoft-maintained public-preview MCP server that provides Microsoft 365 work-information queries through stdio and an npm package. EULA acceptance and potentially tenant-administrator consent are required before use.

Strongest · Setup experience 13/20 Weakest · Reliability 8/20

Reliability
8/20
Security and permissions
8/20
Maintenance
10/20
Documentation
12/20
Setup experience
13/20
Why each score
Reliability 8/20
The manifest declares an npm stdio server, and the README provides npx, global-install, and mcp startup paths, making a normal initialization plausible. However, the supplied material contains no committed tests, CI, handshake verification, tool-list evidence, or error-handling evidence. The repository URL also differs from the manifest repository URL, so points are deducted.
Security and permissions 8/20
The README explicitly states that tenant-admin consent is required to access Microsoft 365 data covering emails, meetings, documents, Teams messages, and people information, indicating a broad data scope. The preview plugin additionally advertises create, update, delete, and other direct operations, but there is no evidence of least privilege, data boundaries, dangerous-operation confirmation, credential handling, or data-flow disclosure. No explicit red-line behavior in the prompt is established.
Maintenance 10/20
The project is not archived and has a declared version 0.2.8, 953 stars, and 85 open issues, which are activity signals. Those signals do not establish sustained releases, commit or issue responsiveness, dependency updates, or a security-response process. The license is NOASSERTION, and clear maintainer or governance evidence is absent, so points are deducted.
Documentation 12/20
The README documents Node.js 18+ prerequisites, administrator consent, EULA acceptance, CLI commands, MCP configuration, example queries, updating, and platform support, providing a reviewable basic path. It lacks concrete tool schemas, parameter limits, troubleshooting and diagnostic guidance, service limits, cost information, detailed permission scope, and privacy boundaries. The public-preview status and repository mismatch add uncertainty, so points are deducted.
Setup experience 13/20
The material offers npm global installation, npx execution, a VS Code install link, a generic MCP configuration, and a Node.js requirement, making setup reasonably clear for mainstream clients. Initial EULA acceptance and tenant-admin authorization add organizational dependencies, and there is no actual execution or CI evidence, so the score remains below the static-review ceiling.

Test out of dateListed 2026-07-29

Read the FMRS scoring method →

Fit and risk

What it can accessUses the networkChanges third-party account data

Best for

  • Users who need natural-language access to Microsoft 365 work data
  • Users of GitHub Copilot CLI, VS Code, or other MCP-compatible coding agents and IDEs
  • Organizations able to obtain Microsoft 365 tenant administrator consent

Not for

  • Users who do not need Microsoft 365 tenant-data access
  • Users unable to obtain the required administrator consent
  • Use cases requiring stable, production-only features or APIs

Required permissions

  • Access to Microsoft 365 tenant data requires consent to the required permissions on first access
  • The permissions may require a tenant administrator to grant admin consent
  • The Entra tenant ID can be selected with `--tenant-id`; the default is `common`
  • The EULA must be accepted before first use

Risks and side effects

  • The project is in public preview, so features and APIs may change
  • The server accesses Microsoft 365 tenant data; incorrect permissions or tenant configuration may affect the data available
  • Using npx fetches the latest version, so behavior may change between runs

Setup

Before you start

Runtime:Node.js 18+

Node.js 18+ is required. Install globally with npm and run workiq mcp, or run npx -y @microsoft/workiq mcp directly. Run workiq accept-eula before first use. You can also add the supplied MCP configuration to a compatible coding agent or IDE.

MCP config · JSON
{"workiq":{"command":"npx","args":["-y","@microsoft/workiq@latest","mcp"],"tools":["*"]}}

Works in clients that read an "mcpServers" key. For clients such as VS Code that use a different key, the configurator below converts it.

.vscode/mcp.json
{
  "workiq": {
    "command": "npx",
    "args": [
      "-y",
      "@microsoft/workiq@latest",
      "mcp"
    ],
    "tools": [
      "*"
    ]
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Check that it works

Add the workiq server to your client (npx -y @microsoft/workiq mcp), restart, and ask "What's on my calendar tomorrow?" — a response with your Microsoft 365 meeting data confirms the server works. First use requires admin consent on the tenant and accepting the EULA (workiq accept-eula).

Troubleshooting

  1. Confirm that Node.js 18+, npm, and npx are installed
  2. Run `workiq accept-eula` before first use
  3. Confirm that a tenant administrator has granted the required admin consent
  4. Use `-t` or `--tenant-id` when a specific tenant must be selected
  5. Run `workiq version` to check the installed version
  6. For a global installation, run `npm update -g @microsoft/workiq` to update

Things to try

Once connected, you can ask your AI assistant things like:

  • What are my upcoming meetings this week?
  • Summarize emails from Sarah about the budget
  • Find documents I worked on yesterday
  • Summarize today's messages in the Engineering channel

Use cases

Query upcoming meetings
Summarize emails about a specific topic
Find recently edited documents
Summarize Teams channel messages
Query people and organizational information

Overview

Microsoft Work IQ is an MCP server and CLI for accessing Work IQ. It can query emails, meetings, documents, Teams messages, and people information through Microsoft 365 Copilot. The project is in public preview, so features and APIs may change.

Similar servers

Source revision ab148f405a4a Data synced 2026-10-19 Read the FMRS scoring method