WorkIQ

WorkIQ — Microsoft 365 Data Query

Use this skill to answer questions about Microsoft 365 data: emails, meetings, calendar, documents, Teams messages, and people/org insights. WorkIQ queries data the authenticated user already has permission to access — no extra permissions are granted.

When to use

Invoke this skill whenever the user asks about:

• Emails — "What did Sarah say about the budget?", "Find emails about project X"
• Calendar / meetings — "What's on my calendar tomorrow?", "Who attended the standup last Friday?"
• Documents / files — "Find my recent PowerPoints", "Summarize the Q4 spec document"
• Teams messages — "Summarize today's messages in the Engineering channel"
• People / org — "Who is working on Project Alpha?", "Who is my manager?"
• Meeting notes — "What issues were raised in yesterday's Contoso meeting?"

How to query

Use the exec tool to run WorkIQ. Prefer the global CLI if available, otherwise fall back to npx.

If workiq is on PATH:

workiq ask -q "<natural language question>"

If only npx is available (Node.js required):

npx -y @microsoft/workiq ask -q "<natural language question>"

With a specific Entra tenant ID:

workiq ask -t <tenant-id> -q "<natural language question>"

Query guidelines

• Write questions in natural language — WorkIQ understands context
• Be specific: include names, dates, project names, or channel names when known
• WorkIQ CLI is stateless per call — for follow-ups, include full context in each question
• WorkIQ only returns data the signed-in user has permission to see
• Do not pipe or combine WorkIQ output with other shell commands — run it standalone

Example queries

First-time setup

If WorkIQ has never been used, the EULA must be accepted first. Tell the user to run:

workiq accept-eula

If WorkIQ is not installed at all:

npm install -g @microsoft/workiq
workiq accept-eula

Error handling