Work IQ MCP server

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

📋 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

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

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:

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

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.

# Install globally
npm install -g @microsoft/workiq

# Run the MCP server
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.

Updating

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

# 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	3.0.0: Source-based retrieval and local synthesis, explicit delegation, and structured Microsoft 365 reads/writes.
microsoft-365-agents-toolkit	Toolkit for building and evaluating M365 Copilot declarative agents — scaffolding, manifest authoring, capability configuration, and eval workflows.
workiq-productivity	Read-only WorkIQ productivity insights — email triage, meeting costs, org charts, channel audits, and more.

📖 See 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 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 and 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. 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.