work-iq

1. Accept EULA (Required First)

```bash

npx @microsoft/workiq accept-eula

```

2. Configure MCP

Add to your project's .mcp.json:

```json

{

"mcpServers": {

"workiq": {

"command": "npx",

"args": ["-y", "@microsoft/workiq", "mcp"]

}

}

}

```

3. Authenticate

First query triggers M365 authentication - a browser window opens for sign-in.

4. Start Querying

```

"What meetings do I have tomorrow?"

"Find emails from Sarah about the budget"

"Show Teams messages about the deployment"

```

Email Intelligence

• Find emails by sender, recipient, subject, or content
• Filter by date ranges
• Search across inbox, sent items, and archives

Example: "What did John say about the proposal?"

Calendar & Meetings

• View upcoming meetings
• Search past meetings by title or attendees
• Check your schedule

Example: "What's on my calendar this week?"

Teams Messages

• Search conversations across channels
• Find messages by sender or content
• Locate shared files

Example: "Summarize today's messages in Engineering channel"

Document Search

• Query SharePoint and OneDrive content
• Search by file type, author, or content
• Find recently modified documents

Example: "Find my recent PowerPoint presentations"

I load automatically when you mention:

• work iq, workiq, m365, microsoft 365
• check my email, find meetings, search teams
• query calendar, office 365, o365

| Command | Description |

| --------------------- | -------------------------------------------------- |

| workiq accept-eula | Accept End User License Agreement (required first) |

| workiq ask | Interactive query mode |

| workiq ask -q "..." | Ask a specific question |

| workiq mcp | Start MCP server (used by Claude Code) |

| workiq version | Show version info |

1. Microsoft 365 Account - Active M365 subscription
2. Node.js - For npx command
3. Admin Consent - May be required for some M365 tenants

| Problem | Solution |

| ------------------------ | --------------------------------------- |

| "EULA not accepted" | Run npx @microsoft/workiq accept-eula |

| "Authentication failed" | Re-run query to trigger fresh auth flow |

| "Admin consent required" | Contact your M365 tenant administrator |

| "WSL browser issues" | Install xdg-utils and wslu packages |

• [Technical Reference](./reference.md) - Installation, configuration, authentication
• [Usage Examples](./examples.md) - Real-world query patterns

• Windows (x64, arm64)
• macOS (x64, arm64)
• Linux (x64, arm64)
• WSL (with browser support)

---

References:

• [Work IQ GitHub](https://github.com/microsoft/work-iq-mcp)
• [NPM Package](https://www.npmjs.com/package/@microsoft/workiq)
• [Admin Consent Overview](https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/user-admin-consent-overview)

Version: 1.0.0 | Updated: 2026-01-23