@yglabs/workiq

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

@yglabs/workiq packages the full Work IQ HTTP MCP surfaces as a local stdio MCP CLI.

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_user": {
      "command": "npx",
      "args": ["-y", "@yglabs/workiq@latest", "mcp", "--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
workiq mcp --server user

Authentication

Sign in and cache a token before starting the MCP server:

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

Useful auth options:

• --account <[email protected]> to prefer a specific Microsoft account
• --client-id <GUID> to override the default Entra public client id

Updating

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

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

Using npx?

npx -y @yglabs/workiq@latest mcp --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 list-servers to print the built-in aliases and URLs
• workiq login to sign in and cache tokens
• workiq logout to clear cached tokens
• workiq mcp to start the local stdio MCP proxy

Examples:

workiq list-servers
workiq login --server mail
workiq mcp --server teams

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

workiq login --url https://example.contoso.com/agents/.../servers/mcp_Custom
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 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.