Agent skill
work-iq
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.
Install this agent skill to your Project
npx add-skill https://github.com/rysweet/amplihack/tree/main/.claude/skills/work-iq
SKILL.md
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
| 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 |
Prerequisites
- Microsoft 365 Account - Active M365 subscription
- Node.js - For npx command
- Admin Consent - May be required for some M365 tenants
Quick Troubleshooting
| 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 |
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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
rysweet/amplihack
chemist-analyst
Analyzes events through chemistry lens using molecular structure, reaction mechanisms, thermodynamics, kinetics, and analytical techniques (spectroscopy, chromatography, mass spectrometry). Provides insights on chemical processes, material properties, reaction pathways, synthesis, and analytical methods. Use when: Chemical reactions, material analysis, synthesis planning, process optimization, environmental chemistry. Evaluates: Molecular structure, reaction mechanisms, yield, selectivity, safety, environmental impact.
rysweet/amplihack
learning-path-builder
Creates personalized learning paths for technologies, frameworks, or concepts. Use for user-interactive session only for onboarding new technologies, hackathon skill-building, or personal development planning. Not for use in automated development or investigation. Sequences resources (docs, tutorials, exercises) based on current skill level and learning goals. Adapts to learning style: hands-on, theory-first, project-based.
rysweet/amplihack
gh-work-report
Generates comprehensive GitHub activity reports across all authenticated accounts. Gathers repos, PRs, features, and themes for configurable time periods (1/5/7/30/90 days). Produces shareable markdown with tables, mermaid charts, and executive summaries. Can create a private repo with GitHub Actions automation and GitHub Pages aggregation site. Use when: "github report", "work report", "activity summary", "what did I work on", "gh-work-report", "show my github activity".
rysweet/amplihack
pr-review-assistant
Philosophy-aware PR reviews checking alignment with amplihack principles. Use when reviewing PRs to ensure ruthless simplicity, modular design, and zero-BS implementation. Suggests simplifications, identifies over-engineering, verifies brick module structure. Posts detailed, constructive review comments with specific file:line references.
rysweet/amplihack
code-smell-detector
Identifies anti-patterns specific to amplihack philosophy. Use when reviewing code for quality issues or refactoring. Detects: over-abstraction, complex inheritance, large functions (>50 lines), tight coupling, missing __all__ exports. Provides specific fixes and explanations for each smell.
rysweet/amplihack
biologist-analyst
Analyzes living systems and biological phenomena through biological lens using evolution, molecular biology, ecology, and systems biology frameworks. Provides insights on mechanisms, adaptations, interactions, and life processes. Use when: Biological systems, health issues, evolutionary questions, ecological problems, biotechnology. Evaluates: Function, structure, heredity, evolution, interactions, molecular mechanisms.
Didn't find tool you were looking for?