Microsoft WorkIQ

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 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.

Before getting started, ensure you have Node.js (which includes NPM and NPX) installed:

Node.js 18+—Download from nodejs.org

You can verify your installation by running:

node --version
npm --version

💡

Why Node.js?WorkIQ uses NPX to run the MCP server. NPX is included automatically with NPM, which comes bundled with Node.js.

copilot

/plugin marketplace add microsoft/work-iq

/plugin install workiq@work-iq
/plugin install workiq-preview@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

If you prefer to run WorkIQ as a standalone MCP server:

npm install -g @microsoft/workiq

workiq mcp

Or use npx without installing:

npx -y @microsoft/workiq mcp

Or add it as an MCP server in your coding agent or IDE:

{
  "workiq": {
    "command": "npx",
    "args": ["-y", "@microsoft/workiq@latest", "mcp"],
    "tools": ["*"]
  }
}

Note: please refer to

[use MCP servers in VS Code]for the configuration instructions relative to Visual Studio Code.

If you installed WorkIQ globally with npm, run the following command to update to the latest version:

npm update -g @microsoft/workiq

To verify the installed version after updating:

workiq version

💡

Using npx?If you run WorkIQ vianpx -y @microsoft/workiq mcp

, npx automatically fetches the latest version each time, so no manual update step is needed.

workiq accept-eula

workiq ask

workiq ask -q "What meetings do I have tomorrow?"

workiq ask -t "your-tenant-id" -q "Show my emails"

workiq mcp

workiq-preview****Preview build. Same natural-language access asworkiq

, plus a broader set of entity tools (fetch, create, update, delete, do-action, call-function, blob downloads, schema discovery) for direct, structured M365 reads and writes.microsoft-365-agents-toolkit****workiq-productivity📖

Seefor the full plugin catalog with detailed skill listings, example prompts, MCP server info, and installation instructions.[PLUGINS.md]

The WorkIQ CLI and MCP Server are supported on win_x64

, win_arm64

, linux_x64

, linux_arm64

, osx_x64

and osx_arm64

.

We welcome new plugins! See CONTRIBUTING.md for the full guide. In short:

• Create your plugin under plugins/{your-plugin}/

• Add .mcp.json

,README.md

, andskills/{name}/SKILL.md

• Register it in .github/plugin/marketplace.json

• Submit a pull request

By using this package, you accept the license agreement. See NOTICES.TXT and EULA within the package for legal terms.

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. 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.