work-iq
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/microsoft/work-iq with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/microsoft/work-iq'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/microsoft--work-iq)HTML
<a href="/listings/microsoft--work-iq"><img src="/api/listings/microsoft--work-iq/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
# 1. Open GitHub Copilot CLI copilot # 2. Add this plugin marketplace (one-time setup) /plugin marketplace add microsoft/work-iq # 3. Install any plugin /plugin install workiq@work-iq /plugin install microsoft-365-agents-toolkit@work-iq /plugin install workiq-productivity@work-iq
**That's it!** Restart Copilot CLI and start using the plugin:
You: What are my upcoming meetings this week? You: Summarize emails from Sarah about the budget You: Find documents I worked on yesterday
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 27 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- {
- "name": "work-iq",
- "owner": {
- "name": "Microsoft",
- "email": "workiq@microsoft.com"
- },
- "plugins": [
- {
- "name": "workiq",
- "description": "WorkIQ for Microsoft 365 mail, calendar, Teams, files, SharePoint, people, Planner and Business Applications. Use retrieve with source-based strategy selection to find evidence and summarize locally. Use ask only for a requested Copilot or named-agent answer; use entity tools for specific reads and operations, with confirmation before mutations. If workiq and workiq-preview are both installed, prefer workiq-preview only if its installed version is higher than workiq's; otherwise prefer workiq.",
- "version": "3.0.0",
- "source": "./plugins/workiq"
- },
- {
- "name": "microsoft-365-agents-toolkit",
- "description": "Toolkit for building and evaluating Microsoft 365 Copilot declarative agents \u2014 scaffolding, JSON manifest development, capability configuration, and eval workflows.",
- "version": "1.4.0",
- "source": "./plugins/microsoft-365-agents-toolkit"
- },
- {
- "name": "workiq-productivity",
- "description": "WorkIQ productivity skills powered by the local WorkIQ CLI \u2014 read-only insights across email, meetings, calendar, Teams, SharePoint, projects, and people.",
- "version": "1.0.0",
- "source": "./plugins/workiq-productivity"
- }
- ]
- }
README.md · README · 223 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Microsoft Work IQ — Plugin Marketplace
- > The official Microsoft Work IQ plugin collection for GitHub Copilot ✨
- Extend the power of GitHub Copilot with Work IQ plugins — MCP servers, skills, and tools that connect AI assistants to your Microsoft 365 data.
- > ⚠️ **Public Preview:** Features and APIs may change.
- To access Microsoft 365 tenant data, the WorkIQ CLI and MCP Server need to be consented to permissions that require administrative rights on the tenant. On first access, a consent dialog appears. If you are not an administrator, contact your tenant administrator to grant access.
- **For Tenant Administrators:** See the [Tenant Administrator Enablement Guide](./ADMIN-INSTRUCTIONS.md) for detailed instructions on granting admin consent, including a quick one-click consent URL.
- For more information, see Microsoft's [User and Admin Consent Overview](https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/user-admin-consent-overview).
- ## 📋 Prerequisites
- The `workiq` plugin connects to a hosted MCP endpoint; it does not need a local
- Node.js runtime or launch an NPX server. Tenant consent and appropriate Microsoft
- 365 licensing are still required.
- **Node.js 18+** is needed for the separate local WorkIQ CLI and CLI-backed
- productivity skills below. Optional WorkIQ Files CLI transfers require
- **Node.js 20+**, separate installation and explicit permission before accepting
- the Files CLI EULA. Other plugins have their own prerequisites.
- ---
- ## 🚀 Quick Start with GitHub Copilot CLI
- ```bash
- # 1. Open GitHub Copilot CLI
- copilot
- # 2. Add this plugin marketplace (one-time setup)
- /plugin marketplace add microsoft/work-iq
- # 3. Install any plugin
- /plugin install workiq@work-iq
- /plugin install microsoft-365-agents-toolkit@work-iq
- /plugin install workiq-productivity@work-iq
- ```
- **That's it!** Restart Copilot CLI and start using the plugin:
- ```
- You: What are my upcoming meetings this week?
- You: Summarize emails from Sarah about the budget
- You: Find documents I worked on yesterday
- ```
- ---
- ## Migrating from workiq-preview
- Stable **3.0.0** replaces stable **2.0.2** with retrieve-first evidence gathering
- and local synthesis, explicit Copilot/named-agent delegation, progressive
- guidance and exact entity operations. Retrieval availability remains
- tenant-dependent; installation does not enable it, and missing retrieval never
- silently falls back to `ask`. See the [stable plugin guide](plugins/workiq/README.md).
- The public `workiq-preview` package is retired. Remove an existing installation
- before installing/updating stable, since older preview skills claim
- precedence over stable for overlapping requests:
- ```bash
- copilot plugin uninstall workiq-preview
- copilot plugin install workiq@work-iq
- ```
- Restart your session afterward. Registry removal does not uninstall an existing
- plugin or replace instructions already loaded in a running session.
- Future WorkIQ development preview remains internal; this GitHub marketplace
- publishes promoted stable WorkIQ releases, alongside the other plugins.
- ---
- ## 📦 Alternative: Standalone MCP Installation
- [](https://vscode.dev/redirect/mcp/install?name=workiq&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40microsoft%2Fworkiq%22%2C%22mcp%22%5D%7D)
- [](https://insiders.vscode.dev/redirect/mcp/install?name=workiq&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40microsoft%2Fworkiq%22%2C%22mcp%22%5D%7D&quality=insiders)
- If you prefer to run WorkIQ as a standalone MCP server:
- This separate CLI-backed integration is not the hosted `workiq` plugin, does
- not load its skill instructions by itself, and does not inherit the plugin's
- version. The following Node.js/NPX commands apply to the CLI.
- ```bash
- # Install globally
- npm install -g @microsoft/workiq
- # Run the MCP server
- workiq mcp
- ```
- Or use npx without installing:
- ```bash
- npx -y @microsoft/workiq mcp
- ```
- Or add it as an MCP server in your coding agent or IDE:
- ```json
- {
- "workiq": {
- "command": "npx",
- "args": ["-y", "@microsoft/workiq@latest", "mcp"],
- "tools": ["*"]
- }
- }
- ```
- > Note: please refer to [use MCP servers in VS Code](https://code.visualstudio.com/docs/copilot/customization/mcp-servers) for the configuration instructions relative to Visual Studio Code.
- ### Updating
- If you installed WorkIQ globally with npm, run the following command to update to the latest version:
- ```bash
- npm update -g @microsoft/workiq
- ```
- To verify the installed version after updating:
- ```bash
- workiq version
- ```
- > 💡 **Using npx?** If you run WorkIQ via `npx -y @microsoft/workiq mcp`, npx automatically fetches the latest version each time, so no manual update step is needed.
- ---
- ## 🎯 What You Can Query
- | Data Type | Example Questions |
- |-----------|-------------------|
- | **Emails** | "What did John say about the proposal?" |
- | **Meetings** | "What's on my calendar tomorrow?" |
- | **Documents** | "Find my recent PowerPoint presentations" |
- | **Teams** | "Summarize today's messages in the Engineering channel" |
- | **People** | "Who is working on Project Alpha?" |
- ---
- ## 📖 CLI Reference
- ### Commands
- | Command | Description |
- |---------|-------------|
- | `workiq ask` | Ask a question to a specific agent or run in interactive mode |
- | `workiq mcp` | Start MCP stdio server for agent communication |
- | `workiq version` | Show version information |
- ### Global Options
- | Option | Description | Default |
- |--------|-------------|---------|
- | `-t, --tenant-id <tenant-id>` | The Entra tenant ID to use for authentication | `common` |
- | `--version` | Show version information | |
- | `-?, -h, --help` | Show help and usage information | |
- ### `workiq ask` Options
- | Option | Description |
- |--------|-------------|
- | `-q, --question <question>` | The question to ask the agent |
- ### Examples
- ```bash
- # Interactive mode
- workiq ask
- # Ask a specific question
- workiq ask -q "What meetings do I have tomorrow?"
- # Use a specific tenant
- workiq ask -t "your-tenant-id" -q "Show my emails"
- # Start MCP server
- workiq mcp
- ```
- ---
- ## 🔌 Available Plugins
- | Plugin | Description |
- |--------|-------------|
- | [**workiq**](./plugins/workiq/) | **3.0.0:** Source-based retrieval and local synthesis, explicit delegation, and structured Microsoft 365 reads/writes. |
- | [**microsoft-365-agents-toolkit**](./plugins/microsoft-365-agents-toolkit/) | Toolkit for building and evaluating M365 Copilot declarative agents — scaffolding, manifest authoring, capability configuration, and eval workflows. |
- | [**workiq-productivity**](./plugins/workiq-productivity/) | Read-only WorkIQ productivity insights — email triage, meeting costs, org charts, channel audits, and more. |
- > 📖 **See [PLUGINS.md](./PLUGINS.md)** for the full plugin catalog with detailed skill listings, example prompts, MCP server info, and installation instructions.
- ---
- ## Platform Support
- The WorkIQ CLI and MCP Server are supported on `win_x64`, `win_arm64`, `linux_x64`, `linux_arm64`, `osx_x64` and `osx_arm64`.
- ---
- ## 🤝 Contributing
- We welcome new plugins! See [CONTRIBUTING.md](./CONTRIBUTING.md) for the full guide. In short:
- 1. Create your plugin under `plugins/{your-plugin}/`
- 2. Add `.mcp.json`, `README.md`, and `skills/{name}/SKILL.md`
- 3. Register it consistently in `marketplace.json` and `.claude-plugin/marketplace.json`
- 4. Submit a pull request
- ---
- ## 📄 License
- By using this package, you accept the license agreement. See [LICENSE](./LICENSE) and [NOTICES.TXT](./NOTICES.TXT) for legal terms.
- ## Trademarks
- This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow [Microsoft’s Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general). Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos is subject to those third-party's policies.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.