Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,8 @@
"plugins": [
{
"name": "workiq",
"description": "Query Microsoft 365 data with natural language \u2014 emails, meetings, documents, Teams messages, and more.",
"version": "1.0.0",
"description": "Full WorkIQ tool surface \u2014 agentic queries via ask plus direct reads and writes (create, update, delete, send, upload) across emails, meetings, calendar, documents, Teams, OneDrive, and SharePoint.",
"version": "2.0.0",
"source": "./plugins/workiq"
},
{
Expand Down
8 changes: 4 additions & 4 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,13 +67,13 @@ plugins/<plugin-name>/

### Available plugins

- **workiq** — Query Microsoft 365 data with natural language. Bundles:
- `workiq` skill — Guides usage of the `ask_work_iq` MCP tool for emails, meetings, documents, Teams messages, and people
- MCP server (`@microsoft/workiq`) with tools: `ask_work_iq`, `accept_eula`, `get_debug_link`
- **workiq** — Full WorkIQ tool surface for Microsoft 365 (read + write). Bundles:
- `workiq` skill — Guides usage of `ask` for semantic questions plus the entity tools for fast, structured M365 reads and writes
- Hosted MCP server (`workiq`) with tools: `ask_work_iq`, `fetch_work_iq`, `fetch_blob_work_iq`, `get_schema_work_iq`, `search_paths_work_iq`, `create_entity_work_iq`, `update_entity_work_iq`, `delete_entity_work_iq`, `do_action_work_iq`, `call_function_work_iq`, `upload_blob_work_iq`, `accept_eula`, `get_debug_link`
Comment on lines +70 to +72

- **workiq-preview** — Preview build with the full WorkIQ tool surface (read + write). Bundles:
- `workiq-preview` skill — Guides usage of `ask_work_iq` for semantic questions plus the entity tools for fast, structured M365 reads and writes
- MCP server (`@microsoft/workiq@preview`) with tools: `ask_work_iq`, `fetch_work_iq`, `fetch_blob_work_iq`, `get_schema_work_iq`, `search_paths_work_iq`, `create_entity_work_iq`, `update_entity_work_iq`, `delete_entity_work_iq`, `do_action_work_iq`, `call_function_work_iq`, `upload_blob_work_iq`, `accept_eula`, `get_debug_link`
- Hosted MCP server (`workiq-preview`) with tools: `ask_work_iq`, `fetch_work_iq`, `fetch_blob_work_iq`, `get_schema_work_iq`, `search_paths_work_iq`, `create_entity_work_iq`, `update_entity_work_iq`, `delete_entity_work_iq`, `do_action_work_iq`, `call_function_work_iq`, `upload_blob_work_iq`, `accept_eula`, `get_debug_link`

- **microsoft-365-agents-toolkit** — Toolkit for building M365 Copilot declarative agents. Bundles:
- `install-atk` skill — Install or update the M365 Agents Toolkit CLI and VS Code extension
Expand Down
29 changes: 9 additions & 20 deletions PLUGINS.md
Original file line number Diff line number Diff line change
Expand Up @@ -77,7 +77,7 @@ copilot plugin uninstall workiq-productivity

| # | Plugin | Skills | Description |
|---|--------|--------|-------------|
| 1 | [**workiq**](#workiq) | 1 | Query Microsoft 365 data with natural language |
| 1 | [**workiq**](#workiq) | 1 | Full WorkIQ tool surface — agentic queries plus direct M365 reads and writes |
| 2 | [**workiq-preview**](#workiq-preview) | 1 | Preview build with the full entity tool surface (read + write) |
| 3 | [**microsoft-365-agents-toolkit**](#microsoft-365-agents-toolkit) | 4 | Toolkit for building M365 Copilot declarative agents |
| 4 | [**workiq-productivity**](#workiq-productivity) | 9 | Read-only productivity insights across M365 |
Expand All @@ -86,45 +86,34 @@ copilot plugin uninstall workiq-productivity

## workiq

> Query Microsoft 365 data with natural language — emails, meetings, documents, Teams messages, and more.
> Full WorkIQ tool surface for GitHub Copilot CLI: agentic semantic queries via `ask` **plus** direct, structured reads and writes against Microsoft 365 — emails, meetings, calendar, documents, Teams messages, OneDrive/SharePoint files, and people.

**Install:** `/plugin install workiq@work-iq`
**Source:** [`plugins/workiq/`](./plugins/workiq/)

### MCP Servers

[![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)
[![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)

| Server | Tools |
|--------|-------|
| `@microsoft/workiq` | `ask_work_iq`, `accept_eula`, `get_debug_link` |
| `workiq` (hosted) | `ask_work_iq`, `fetch_work_iq`, `fetch_blob_work_iq`, `get_schema_work_iq`, `search_paths_work_iq`, `create_entity_work_iq`, `update_entity_work_iq`, `delete_entity_work_iq`, `do_action_work_iq`, `call_function_work_iq`, `upload_blob_work_iq`, `accept_eula`, `get_debug_link` |

Comment on lines 96 to 99
### Skills

| Skill | Description |
|-------|-------------|
| [**workiq**](./plugins/workiq/skills/workiq/SKILL.md) | Guides usage of the `ask_work_iq` MCP tool for emails, meetings, documents, Teams messages, and people |
| [**workiq**](./plugins/workiq/skills/workiq/SKILL.md) | Guides usage of the full WorkIQ tool surface — `ask` for semantic questions plus entity tools for fast, structured M365 reads and writes |

### Example prompts

```
"What did John say about the proposal?"
"What's on my calendar tomorrow?"
"Find my recent PowerPoint presentations"
"Summarize today's messages in the Engineering channel"
"Who is working on Project Alpha?"
"List my unread emails from Sarah this week"
"Create a calendar event Friday at 3pm with the design team"
"Accept the 2pm meeting from Rob"
"Send the draft email to the engineering distribution list"
"Show me the channels in the DevX team"
```

### CLI commands

| Command | Description |
|---------|-------------|
| `workiq accept-eula` | Accept the End User License Agreement |
| `workiq ask` | Ask a question or enter interactive mode |
| `workiq mcp` | Start MCP stdio server |
| `workiq version` | Show version information |

---

## workiq-preview
Expand Down
4 changes: 2 additions & 2 deletions marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,8 @@
{
"name": "workiq",
"source": "./plugins/workiq",
"description": "Query Microsoft 365 data with natural language \u2014 emails, meetings, documents, Teams messages, and more.",
"version": "1.0.0"
"description": "Full WorkIQ tool surface \u2014 agentic queries via ask plus direct reads and writes (create, update, delete, send, upload) across emails, meetings, calendar, documents, Teams, OneDrive, and SharePoint.",
"version": "2.0.0"
},
Comment on lines 9 to 13
{
"name": "workiq-preview",
Expand Down
4 changes: 2 additions & 2 deletions plugins/workiq/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "workiq",
"version": "1.0.0",
"description": "Query Microsoft 365 data with natural language \u2014 emails, meetings, documents, Teams messages, and more.",
"version": "2.0.0",
"description": "Full WorkIQ tool surface — agentic queries via ask plus direct reads and writes (create, update, delete, send, upload) across emails, meetings, calendar, Planner tasks, documents, Teams, people and contacts, OneDrive, and SharePoint.",
"skills": "./skills/"
Comment on lines +3 to 5
}
4 changes: 2 additions & 2 deletions plugins/workiq/.codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "workiq",
"version": "1.0.0",
"description": "Query Microsoft 365 data with natural language \u2014 emails, meetings, documents, Teams messages, and more.",
"version": "2.0.0",
"description": "Full WorkIQ tool surface — agentic queries via ask plus direct reads and writes (create, update, delete, send, upload) across emails, meetings, calendar, Planner tasks, documents, Teams, people and contacts, OneDrive, and SharePoint.",
"skills": "./skills/"
Comment on lines +3 to 5
}
4 changes: 2 additions & 2 deletions plugins/workiq/.github/plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "workiq",
"version": "1.0.0",
"description": "Query Microsoft 365 data with natural language \u2014 emails, meetings, documents, Teams messages, and more.",
"version": "2.0.0",
"description": "Full WorkIQ tool surface — agentic queries via ask plus direct reads and writes (create, update, delete, send, upload) across emails, meetings, calendar, Planner tasks, documents, Teams, people and contacts, OneDrive, and SharePoint.",
"skills": "./skills/"
Comment on lines +3 to 5
}
10 changes: 7 additions & 3 deletions plugins/workiq/.mcp.json
Original file line number Diff line number Diff line change
@@ -1,9 +1,13 @@
{
"mcpServers": {
"workiq": {
"command": "npx",
"args": ["-y", "@microsoft/workiq@latest", "mcp"],
"tools": ["*"]
"type": "http",
"url": "https://workiq.svc.cloud.microsoft/mcp",
"oauthClientId": "ba081686-5d24-4bc6-a0d6-d034ecffed87",
"oauthPublicClient": true,
"auth": {
"redirectPort": 12798
}
}
}
}
72 changes: 43 additions & 29 deletions plugins/workiq/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Work IQ Plugin

> Query Microsoft 365 data with natural language — emails, meetings, documents, Teams messages, and more.
Full WorkIQ tool surface for GitHub Copilot CLI: agentic semantic queries via `ask` **plus** direct, structured reads and writes against Microsoft 365 — emails, meetings, calendar, documents, Teams messages, OneDrive/SharePoint files, and people.

## Installation

Expand All @@ -16,57 +16,71 @@ Add to your `.mcp.json` or IDE MCP settings:

```json
{
"workiq": {
"command": "npx",
"args": ["-y", "@microsoft/workiq@latest", "mcp"],
"tools": ["*"]
"mcpServers": {
"workiq": {
"type": "http",
"url": "https://workiq.svc.cloud.microsoft/mcp",
"oauthClientId": "ba081686-5d24-4bc6-a0d6-d034ecffed87",
"oauthPublicClient": true,
"auth": {
"redirectPort": 12798
}
}
}
}
```

## Updating

If you installed WorkIQ globally with npm, run the following command to update to the latest version:
The plugin connects to the hosted WorkIQ MCP prod endpoint. It does **not** launch a local MCP server for tool calls.

```bash
npm update -g @microsoft/workiq
```
## Updating

To verify the installed version after updating:
The MCP tool surface is served by the hosted WorkIQ endpoint above, so updating a local package is not required for MCP tool calls.

```bash
workiq version
```
## Usage

> 💡 **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.
The plugin exposes the WorkIQ MCP tool surface — read **and** write — from `https://workiq.svc.cloud.microsoft/mcp`.

## Usage
### Semantic queries (`ask`)

```
# Emails
"What did John say about the proposal?"
"Summarize emails from the leadership team this week"
"What's top of mind for Sarah?"
"Find the design doc for the authentication system"
"Who is working on Project Alpha?"
```

# Meetings
"What's on my calendar tomorrow?"
"What are my upcoming meetings this week?"
### Structured reads (`fetch`, `search_paths`, `get_schema`, `fetch_blob`)

Comment on lines +53 to +54
```
"List my unread emails from Sarah this week"
"What meetings do I have Monday?"
"Show me the channels in the DevX team"
"List files in my OneDrive 'Specs' folder"
"Who are Rob's direct reports?"
```

# Documents
"Find my recent PowerPoint presentations"
"Find documents I worked on yesterday"
### Writes (`create_entity`, `update_entity`, `delete_entity`, `do_action`, `upload_blob`)

# Teams
"Summarize today's messages in the Engineering channel"
> ⚠️ Writes execute immediately and are visible to other people or unrecoverable. The skill is instructed to confirm with you before sending mail, forwarding, accepting/declining meetings, or permanently deleting.
Comment on lines +63 to +65

# People
"Who is working on Project Alpha?"
```
"Send the draft email to the engineering distribution list"
"Create a calendar event Friday at 3pm with the design team"
"Accept the 2pm meeting from Rob"
"Decline the Monday standup — I'll catch up on the recording"
"Mark Sarah's last three emails as read"
"Reply to the deadline thread with 'on track for Friday'"
"Move the design review thread to the Archive folder"
```

> ⚠️ `fetch_blob` and `upload_blob` are documented for future reference but are not released in the current WorkIQ MCP surface. For downloads, fetch metadata and return `webUrl`; for uploads, direct the user to OneDrive / SharePoint until raw byte support is released.

## Skills

| Skill | Description |
|-------|-------------|
| [**workiq**](./skills/workiq/SKILL.md) | Query M365 Copilot for workplace intelligence |
| [**workiq**](./skills/workiq/SKILL.md) | Guides usage of the full WorkIQ tool surface — `ask` for semantic questions plus entity tools for fast, structured M365 reads and writes |

## Platform Support

Expand Down
Loading