mcpField
W
work-iq

work-iq

github.com/rysweetProductivity76131 installsUpdated 21w ago
Repository

About work-iq

Work IQ Skill lets Microsoft 365 users query email, calendar, Teams, SharePoint, and OneDrive content in natural language from a development environment. It connects through the workiq MCP server and also offers interactive and direct-query CLI commands.

Key features

  1. 01Search email by sender, subject, content, or date
  2. 02Review upcoming and past meetings
  3. 03Search Teams conversations and shared files
  4. 04Find SharePoint and OneDrive documents
  5. 05Interactive and direct-query CLI modes

Use cases

  1. 01Find messages about a specific topic
  2. 02Check upcoming meetings or past attendees
  3. 03Locate discussions and files in Teams
  4. 04Find recent documents by type or author

MCP support

It uses the workiq MCP server to expose Microsoft 365 queries to compatible clients. The server must be enabled and configured in `.mcp.json` before use.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/rysweet/amplihack --skill work-iq

After installing, type/work-iqin Claude Code to confirm it loaded.

Bundled filesexamples.mdreference.md

Details

From the project README

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

CommandDescription
workiq accept-eulaAccept End User License Agreement (required first)
workiq askInteractive query mode
workiq ask -q "..."Ask a specific question
workiq mcpStart MCP server (used by Claude Code)
workiq versionShow 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

Platform Support

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

References:

Version: 1.0.0 | Updated: 2026-01-23

Comments

Markdown supported