@yglabs/workiq-mcp

Query Microsoft 365 data through the full Work IQ HTTP MCP servers: mail, calendar, documents, Teams, OneDrive, SharePoint, Copilot, and more.

@yglabs/workiq-mcp packages the full Work IQ HTTP MCP surfaces as a local stdio MCP CLI. The mcp subcommand is optional: workiq-mcp --server user is equivalent to workiq-mcp mcp --server user.

Prerequisites

Before getting started, make sure you have:

• Node.js 16 or later
• Access to the Work IQ HTTP MCP servers in your Microsoft 365 tenant
• Permission to complete Microsoft sign-in and consent for your tenant

You can verify your Node.js installation with:

node --version
npm --version

Installation

Via MCP Configuration

Add this to your .mcp.json or your IDE's MCP settings:

{
  "mcpServers": {
    "workiq_mcp_user": {
      "command": "npx",
      "args": ["-y", "@yglabs/workiq-mcp@latest", "--server", "user"],
      "tools": ["*"]
    }
  }
}

To target a different built-in Work IQ surface, replace user with one of:

• word
• mail
• calendar
• teams
• onedrive
• sharepoint
• copilot

Via npm

If you prefer a global install:

npm install -g @yglabs/workiq-mcp
workiq-mcp --server user

Authentication

Authentication is triggered automatically when you start the MCP proxy (workiq-mcp --server ... or workiq-mcp mcp ...). Tokens are cached locally after successful sign-in.

Useful auth options (for mcp):

• --account <[email protected]> to prefer a specific Microsoft account
• --client-id <GUID> to override the default Entra public client id
• --force-device-code to force device code fallback after silent auth and avoid browser popups

Updating

If you installed @yglabs/workiq-mcp globally with npm, update it with:

npm update -g @yglabs/workiq-mcp
workiq-mcp --version

Using npx?

npx -y @yglabs/workiq-mcp@latest --server user

npx fetches the current published package automatically, so there is usually no separate update step.

Usage

Mail

• "What did John say about the proposal?"
• "Summarize emails from the leadership team this week."

Meetings and Calendar

• "What are my upcoming meetings this week?"
• "What's on my calendar tomorrow?"

Documents

• "Find my recent PowerPoint presentations."
• "Find documents I worked on yesterday."

Teams

• "Summarize today's messages in the Engineering channel."
• "What decisions were made in our project chat?"

OneDrive and SharePoint

• "Find the latest project plan in SharePoint."
• "Show the spreadsheets I edited this week."

Copilot and User Data

• "What follow-ups do I owe after this week's meetings?"
• "Summarize the main themes from my recent work."

Commands

The CLI currently provides:

• workiq-mcp version to print CLI version information
• workiq-mcp list-servers to print the built-in aliases and URLs
• workiq-mcp to start the default local stdio MCP proxy

Examples:

workiq-mcp version
workiq-mcp list-servers
workiq-mcp --server teams

To target a Work IQ HTTP MCP endpoint that is not one of the built-in aliases, use --url:

workiq-mcp --url https://example.contoso.com/agents/.../servers/mcp_Custom

Built-in Servers

The built-in aliases currently map to these Work IQ surfaces:

• user
• word
• mail
• calendar
• teams
• onedrive
• sharepoint
• copilot

Run workiq-mcp list-servers to print the exact endpoint URLs included in the current build.

Platform Support

Supported on:

• win-x64
• win-arm64
• linux-x64
• linux-arm64
• osx-x64
• osx-arm64

License

See LICENSE.