Skip to content
Back to search

work-iq

MCP serverGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/microsoft--work-iq/badge.svg)](/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

i

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)

  1. {
  2. "name": "work-iq",
  3. "owner": {
  4. "name": "Microsoft",
  5. "email": "workiq@microsoft.com"
  6. },
  7. "plugins": [
  8. {
  9. "name": "workiq",
  10. "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.",
  11. "version": "3.0.0",
  12. "source": "./plugins/workiq"
  13. },
  14. {
  15. "name": "microsoft-365-agents-toolkit",
  16. "description": "Toolkit for building and evaluating Microsoft 365 Copilot declarative agents \u2014 scaffolding, JSON manifest development, capability configuration, and eval workflows.",
  17. "version": "1.4.0",
  18. "source": "./plugins/microsoft-365-agents-toolkit"
  19. },
  20. {
  21. "name": "workiq-productivity",
  22. "description": "WorkIQ productivity skills powered by the local WorkIQ CLI \u2014 read-only insights across email, meetings, calendar, Teams, SharePoint, projects, and people.",
  23. "version": "1.0.0",
  24. "source": "./plugins/workiq-productivity"
  25. }
  26. ]
  27. }
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)

  1. # Microsoft Work IQ — Plugin Marketplace
  2. > The official Microsoft Work IQ plugin collection for GitHub Copilot ✨
  3. Extend the power of GitHub Copilot with Work IQ plugins — MCP servers, skills, and tools that connect AI assistants to your Microsoft 365 data.
  4. > ⚠️ **Public Preview:** Features and APIs may change.
  5. 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.
  6. **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.
  7. 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).
  8. ## 📋 Prerequisites
  9. The `workiq` plugin connects to a hosted MCP endpoint; it does not need a local
  10. Node.js runtime or launch an NPX server. Tenant consent and appropriate Microsoft
  11. 365 licensing are still required.
  12. **Node.js 18+** is needed for the separate local WorkIQ CLI and CLI-backed
  13. productivity skills below. Optional WorkIQ Files CLI transfers require
  14. **Node.js 20+**, separate installation and explicit permission before accepting
  15. the Files CLI EULA. Other plugins have their own prerequisites.
  16. ---
  17. ## 🚀 Quick Start with GitHub Copilot CLI
  18. ```bash
  19. # 1. Open GitHub Copilot CLI
  20. copilot
  21. # 2. Add this plugin marketplace (one-time setup)
  22. /plugin marketplace add microsoft/work-iq
  23. # 3. Install any plugin
  24. /plugin install workiq@work-iq
  25. /plugin install microsoft-365-agents-toolkit@work-iq
  26. /plugin install workiq-productivity@work-iq
  27. ```
  28. **That's it!** Restart Copilot CLI and start using the plugin:
  29. ```
  30. You: What are my upcoming meetings this week?
  31. You: Summarize emails from Sarah about the budget
  32. You: Find documents I worked on yesterday
  33. ```
  34. ---
  35. ## Migrating from workiq-preview
  36. Stable **3.0.0** replaces stable **2.0.2** with retrieve-first evidence gathering
  37. and local synthesis, explicit Copilot/named-agent delegation, progressive
  38. guidance and exact entity operations. Retrieval availability remains
  39. tenant-dependent; installation does not enable it, and missing retrieval never
  40. silently falls back to `ask`. See the [stable plugin guide](plugins/workiq/README.md).
  41. The public `workiq-preview` package is retired. Remove an existing installation
  42. before installing/updating stable, since older preview skills claim
  43. precedence over stable for overlapping requests:
  44. ```bash
  45. copilot plugin uninstall workiq-preview
  46. copilot plugin install workiq@work-iq
  47. ```
  48. Restart your session afterward. Registry removal does not uninstall an existing
  49. plugin or replace instructions already loaded in a running session.
  50. Future WorkIQ development preview remains internal; this GitHub marketplace
  51. publishes promoted stable WorkIQ releases, alongside the other plugins.
  52. ---
  53. ## 📦 Alternative: Standalone MCP Installation
  54. [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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)
  55. [![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Server-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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)
  56. If you prefer to run WorkIQ as a standalone MCP server:
  57. This separate CLI-backed integration is not the hosted `workiq` plugin, does
  58. not load its skill instructions by itself, and does not inherit the plugin's
  59. version. The following Node.js/NPX commands apply to the CLI.
  60. ```bash
  61. # Install globally
  62. npm install -g @microsoft/workiq
  63. # Run the MCP server
  64. workiq mcp
  65. ```
  66. Or use npx without installing:
  67. ```bash
  68. npx -y @microsoft/workiq mcp
  69. ```
  70. Or add it as an MCP server in your coding agent or IDE:
  71. ```json
  72. {
  73. "workiq": {
  74. "command": "npx",
  75. "args": ["-y", "@microsoft/workiq@latest", "mcp"],
  76. "tools": ["*"]
  77. }
  78. }
  79. ```
  80. > 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.
  81. ### Updating
  82. If you installed WorkIQ globally with npm, run the following command to update to the latest version:
  83. ```bash
  84. npm update -g @microsoft/workiq
  85. ```
  86. To verify the installed version after updating:
  87. ```bash
  88. workiq version
  89. ```
  90. > 💡 **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.
  91. ---
  92. ## 🎯 What You Can Query
  93. | Data Type | Example Questions |
  94. |-----------|-------------------|
  95. | **Emails** | "What did John say about the proposal?" |
  96. | **Meetings** | "What's on my calendar tomorrow?" |
  97. | **Documents** | "Find my recent PowerPoint presentations" |
  98. | **Teams** | "Summarize today's messages in the Engineering channel" |
  99. | **People** | "Who is working on Project Alpha?" |
  100. ---
  101. ## 📖 CLI Reference
  102. ### Commands
  103. | Command | Description |
  104. |---------|-------------|
  105. | `workiq ask` | Ask a question to a specific agent or run in interactive mode |
  106. | `workiq mcp` | Start MCP stdio server for agent communication |
  107. | `workiq version` | Show version information |
  108. ### Global Options
  109. | Option | Description | Default |
  110. |--------|-------------|---------|
  111. | `-t, --tenant-id <tenant-id>` | The Entra tenant ID to use for authentication | `common` |
  112. | `--version` | Show version information | |
  113. | `-?, -h, --help` | Show help and usage information | |
  114. ### `workiq ask` Options
  115. | Option | Description |
  116. |--------|-------------|
  117. | `-q, --question <question>` | The question to ask the agent |
  118. ### Examples
  119. ```bash
  120. # Interactive mode
  121. workiq ask
  122. # Ask a specific question
  123. workiq ask -q "What meetings do I have tomorrow?"
  124. # Use a specific tenant
  125. workiq ask -t "your-tenant-id" -q "Show my emails"
  126. # Start MCP server
  127. workiq mcp
  128. ```
  129. ---
  130. ## 🔌 Available Plugins
  131. | Plugin | Description |
  132. |--------|-------------|
  133. | [**workiq**](./plugins/workiq/) | **3.0.0:** Source-based retrieval and local synthesis, explicit delegation, and structured Microsoft 365 reads/writes. |
  134. | [**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. |
  135. | [**workiq-productivity**](./plugins/workiq-productivity/) | Read-only WorkIQ productivity insights — email triage, meeting costs, org charts, channel audits, and more. |
  136. > 📖 **See [PLUGINS.md](./PLUGINS.md)** for the full plugin catalog with detailed skill listings, example prompts, MCP server info, and installation instructions.
  137. ---
  138. ## Platform Support
  139. The WorkIQ CLI and MCP Server are supported on `win_x64`, `win_arm64`, `linux_x64`, `linux_arm64`, `osx_x64` and `osx_arm64`.
  140. ---
  141. ## 🤝 Contributing
  142. We welcome new plugins! See [CONTRIBUTING.md](./CONTRIBUTING.md) for the full guide. In short:
  143. 1. Create your plugin under `plugins/{your-plugin}/`
  144. 2. Add `.mcp.json`, `README.md`, and `skills/{name}/SKILL.md`
  145. 3. Register it consistently in `marketplace.json` and `.claude-plugin/marketplace.json`
  146. 4. Submit a pull request
  147. ---
  148. ## 📄 License
  149. By using this package, you accept the license agreement. See [LICENSE](./LICENSE) and [NOTICES.TXT](./NOTICES.TXT) for legal terms.
  150. ## Trademarks
  151. 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 in

Free to use. If it’s helped, pass it on.