Work Iq

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

0. Enable MCP Server (Required First)

The workiq MCP server is disabled by default. Enable it before use:

/mcp-manager

Select the workiq server and enable it, or manually set "disabled": false in .mcp.json.

1. Accept EULA (Required First)

npx @microsoft/workiq accept-eula

2. Configure MCP

Add to your project's .mcp.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

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

Documentation

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

Platform Support

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

---

References:

• Work IQ GitHub
• NPM Package
• Admin Consent Overview

Version: 1.0.0 | Updated: 2026-01-23

Work IQ Usage Examples

Real-world examples of using Work IQ to query Microsoft 365 data.

Email Examples

Find Emails by Sender

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

Work IQ: Found 3 emails from John about the proposal:

1. RE: Q4 Proposal Review
   From: John Smith
   Date: Yesterday
   Preview: "I've reviewed the Q4 numbers and have concerns about..."

2. Proposal Updates Needed
   From: John Smith
   Date: 3 days ago
   Preview: "After the client meeting, we need to revise..."

Search by Subject

User: "Find emails about budget approval"

Work IQ: Found 5 emails matching 'budget approval':

1. RE: Q1 Budget Approval - APPROVED
2. Budget Approval Process Update
3. Action Required: Budget Approval
...

Filter by Time

User: "Show me emails from last week about the project deadline"

Work IQ: Found 8 emails from last week about project deadline...

Find Unread Important Emails

User: "What unread emails do I have from my manager?"

Work IQ: You have 2 unread emails from Sarah Chen:

1. Action Required: Review before Friday
2. Team restructuring announcement

Search Sent Items

User: "What did I send to the client about pricing?"

Work IQ: Found 3 emails you sent about pricing:

1. To: client@example.com
   Subject: Updated Pricing Proposal
   Sent: Monday

Calendar & Meeting Examples

View Today's Schedule

User: "What meetings do I have today?"

Work IQ: You have 3 meetings today:

1. 9:00 AM - Daily Standup (15 min, Teams)
2. 11:00 AM - Design Review (1 hr, Room A)
3. 3:00 PM - 1:1 with Manager (30 min, Teams)

Check Tomorrow

User: "What's on my calendar tomorrow?"

Work IQ: Tomorrow's schedule:

1. 10:00 AM - Sprint Planning (2 hrs)
2. 2:00 PM - Client Demo (1 hr)

Find Past Meetings

User: "When did we last meet about the API redesign?"

Work IQ: Found meeting "API Redesign Discussion"
- Date: Last Tuesday, 2:00 PM
- Attendees: You, Alex, Marcus, Sarah
- Duration: 1 hour

Check Specific Day

User: "What meetings do I have next Tuesday?"

Work IQ: Next Tuesday's schedule:
1. 9:30 AM - Architecture Review
2. 1:00 PM - Product Sync
3. 4:00 PM - Retrospective

Find Recurring Meetings

User: "Show my weekly team meetings"

Work IQ: Weekly recurring meetings:

1. Monday 9:00 AM - Weekly Standup
2. Wednesday 2:00 PM - Team Sync
3. Friday 4:00 PM - Week Review

Teams Message Examples

Search Channel Messages

User: "What did the team discuss about the deployment?"

Work IQ: Found discussions in #engineering channel:

- Alex: "Deployment scheduled for Friday 10 PM"
- Sarah: "Do we have rollback plan ready?"
- Marcus: "Rollback tested and documented"

Find Specific Person's Messages

User: "Show me what Alex said in Teams about the security audit"

Work IQ: Messages from Alex about security audit:

1. In #security channel:
   "Audit results came back - 2 medium issues to address"

2. In direct chat:
   "Can you help with the remediation plan?"

Summarize Channel Activity

User: "Summarize today's messages in the Engineering channel"

Work IQ: Today's #engineering activity:

- 15 messages, 6 participants
- Main topics: deployment prep, code review, testing
- Action items: Deploy at 10 PM, review PR #234

Find Shared Links

User: "Find links shared in #project-alpha channel"

Work IQ: Recent links in #project-alpha:

1. Design doc: https://sharepoint.com/doc/...
2. Figma mockups: https://figma.com/file/...
3. Requirements: https://sharepoint.com/req/...

Document Search Examples

Find Recent Documents

User: "Find my recent PowerPoint presentations"

Work IQ: Found 4 PowerPoint files modified recently:

1. Q4 Review.pptx - Modified yesterday
2. Product Roadmap 2026.pptx - Modified 3 days ago
3. Architecture Overview.pptx - Modified last week

Search by Content

User: "Find documents containing 'microservices architecture'"

Work IQ: Found 8 documents:

1. Architecture Decision Record.docx
   Match: "...microservices architecture provides..."

2. Technical Design.pdf
   Match: "...migrating to microservices architecture..."

Find Documents by Author

User: "Show documents Sarah shared with me"

Work IQ: Documents shared by Sarah:

1. Budget Planning.xlsx - Can edit
2. Project Timeline.mpp - Can view
3. Requirements Spec.docx - Can edit

Search Specific Location

User: "Find Excel files in the Engineering folder"

Work IQ: Excel files in /Engineering/:

1. Sprint Metrics.xlsx
2. API Performance.xlsx
3. Test Results.xlsx

Workflow Patterns

Morning Email Triage

1. "Show unread emails from last 12 hours"
2. "Find emails from my manager this week"
3. "What action items are in my recent emails?"

Meeting Preparation

1. "Show my 2 PM meeting details"
2. "Find emails about the project we're discussing"
3. "Show notes from our last meeting on this topic"

Project Context Gathering

1. "Find all emails about Project Phoenix"
2. "Show meetings about Phoenix from last month"
3. "Search Teams in #phoenix channel"
4. "Find documents containing 'Phoenix'"

End-of-Week Review

1. "Show my meetings from this week"
2. "What documents did I create this week?"
3. "Show Teams messages where I was mentioned"

Code Review Context

1. "Find emails from Alex about the auth module"
2. "Search Teams for auth implementation discussions"
3. "Show the architecture decision document"

Incident Response

1. "Find Teams messages in #incidents from last 2 hours"
2. "Show emails about deployment this week"
3. "Find the deployment runbook document"

Tips for Effective Queries

Be Specific

✅ Good: "Find emails from Sarah about the Q4 budget" ❌ Vague: "Show me emails"

Use Time Ranges

✅ Good: "Meetings this week with the design team" ❌ Broad: "All my meetings"

Combine Filters

✅ Good: "Unread emails from last week about deadlines" ❌ Single filter: "Unread emails" (may be too many)

Ask Follow-ups

First: "Find emails about the API project"
Then: "Show me the most recent one"
Then: "What attachments were in that email?"

---

Related Documentation:

• SKILL.md - Overview and quick start
• reference.md - Technical reference

Last Updated: 2026-01-23

Work IQ Technical Reference

Complete technical documentation for Microsoft Work IQ MCP server integration.

Installation Methods

Method 1: NPX (Recommended)

Run on-demand without installation:

npx -y @microsoft/workiq mcp

Method 2: Global Install

npm install -g @microsoft/workiq
workiq version

Method 3: Via MCP Manager

Using amplihack's mcp-manager skill:

cd .claude/scenarios
python3 -m mcp-manager.cli add workiq npx -- -y @microsoft/workiq mcp

MCP Configuration

Basic Configuration

Add to .mcp.json:

{
  "mcpServers": {
    "workiq": {
      "command": "npx",
      "args": ["-y", "@microsoft/workiq", "mcp"]
    }
  }
}

With Specific Tenant

{
  "mcpServers": {
    "workiq": {
      "command": "npx",
      "args": ["-y", "@microsoft/workiq", "mcp"],
      "env": {
        "WORKIQ_TENANT_ID": "your-tenant-id"
      }
    }
  }
}

VS Code Integration

Add to VS Code MCP settings:

{
  "mcp.servers": {
    "workiq": {
      "command": "npx",
      "args": ["-y", "@microsoft/workiq", "mcp"]
    }
  }
}

Authentication

OAuth Flow

1. First Query - Triggers authentication 2. Browser Opens - Sign in to Microsoft 365 3. Grant Permissions - Accept requested permissions 4. Token Cached - Subsequent queries use cached credentials

Admin Consent

Enterprise deployments may require tenant administrator consent:

1. User Attempts Access - Consent dialog appears 2. Admin Reviews - Evaluates permission request 3. Consent Granted - Admin approves via Entra admin center 4. Access Enabled - All users can authenticate

Admin Consent URL:

https://entra.microsoft.com/ → Enterprise applications → WorkIQ → Permissions → Grant admin consent

Required Permissions

Clear Credentials

# Remove cached tokens - platform specific locations:
# Windows: %LOCALAPPDATA%\Microsoft\WorkIQ
# macOS: ~/Library/Application Support/Microsoft/WorkIQ
# Linux: ~/.config/Microsoft/WorkIQ

CLI Command Reference

workiq accept-eula

Accept the End User License Agreement. Required before first use.

workiq accept-eula
# or
npx @microsoft/workiq accept-eula

workiq ask

Query M365 data interactively or with a specific question.

# Interactive mode
workiq ask

# Direct question
workiq ask -q "What meetings do I have tomorrow?"

# Specific tenant
workiq ask -t "your-tenant-id" -q "Show my emails"

workiq mcp

Start MCP stdio server for agent communication.

workiq mcp
# Runs as daemon, invoked by MCP runtime

workiq version

Display version information.

workiq version

Query Patterns

Date Ranges

Query Types

Troubleshooting

EULA Not Accepted

Error: EULA not accepted

Solution:

npx @microsoft/workiq accept-eula

Authentication Failed

Error: Authentication failed

Solutions:

1. Clear cached credentials (see locations above) 2. Verify M365 account is active 3. Check network connectivity 4. Try re-authenticating

Admin Consent Required

Error: Admin consent required for this application

Solutions:

1. Contact M365 tenant administrator 2. Request application consent 3. Admin grants via Entra admin center

WSL Browser Issues

Error: Unable to open browser for authentication

Solution:

sudo apt install xdg-utils
sudo apt install wslu

Rate Limiting

Error: Rate limit exceeded

Solution:

• Wait for cooldown period (usually 60 seconds)
• Reduce query frequency
• Use more specific queries

Security Considerations

Data Access

• Queries scoped to YOUR M365 account
• Respects M365 permissions
• No data sent to third parties (except Microsoft)

Token Storage

• Platform-standard secure storage:
• Windows: Credential Manager
• macOS: Keychain
• Linux: Secret Service API

Best Practices

• Review permissions before granting consent
• Use least-privilege principle
• Revoke access when no longer needed
• Regular access reviews for enterprise

---

Last Updated: 2026-01-23