work-iq

Original：🇺🇸 English
Translated

Microsoft Work IQ MCP integration for querying M365 data (emails, meetings, Teams, documents) with natural language. Enables searching your Microsoft 365 workspace directly from Claude Code.

1installs
Sourcerysweet/amplihack
Added on

NPX Install

npx skill4agent add rysweet/amplihack work-iq

Tags

Translated version includes tags in frontmatter
workiq-integrationm365-data-queryclaude-code-integrationcli-toolmicrosoft-365-skill

SKILL.md Content

View Translation Comparison →

Work IQ Skill

Query your Microsoft 365 workspace using natural language. Search emails, meetings, Teams messages, and documents without leaving your development environment.

Quick Start

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"

Core Capabilities

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"

When This Skill Activates

I load automatically when you mention:
  • work iq, workiq, m365, microsoft 365
  • check my email, find meetings, search teams
  • query calendar, office 365, o365

CLI Commands

CommandDescription
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

Prerequisites

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

Quick Troubleshooting

ProblemSolution
"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

Documentation

  • Technical Reference - Installation, configuration, authentication
  • Usage Examples - Real-world query patterns

Platform Support

  • Windows (x64, arm64)
  • macOS (x64, arm64)
  • Linux (x64, arm64)
  • WSL (with browser support)
References:
Version: 1.0.0 | Updated: 2026-01-23