Ado Cowork Plugin

ADO Cowork Plugin

An AI assistant plugin designed for Project Managers who need live Azure DevOps data without leaving their chat window — and for developers and functional consultants who want the same. Works with Microsoft 365 Copilot, VS Code Copilot agent mode, and any AI assistant that supports the Agent Skills open standard (Claude Code, Cursor, Gemini CLI, JetBrains Junie).

Who is this for?

| Role | Primary workflows | |---|---| | Project Manager | Sprint health, go/no-go readiness, velocity trends, stakeholder updates, backlog grooming, retrospectives, committee PowerPoint decks | | Developer | Pipeline triage, PR reviews, branch management, work item creation, commit history | | Functional consultant | Work item queries, backlog triage, wiki authoring, cross-project search, test plan management | | Consultant / partner with guest access | Register customer orgs once (add org contoso), then switch between your own and any customer Azure DevOps tenant in the same session |

What this plugin does

Eliminates context-switching between your AI assistant and the Azure DevOps web portal. Describe what you need in plain English — the plugin routes the request to the correct Azure DevOps MCP tool and returns structured results directly in your chat window.

For Project Managers:

• "Give me the sprint health report for the Platform team — committed vs completed, slipped items."
• "Is v2.0 ready to go live? Show open P1 bugs, build status, and test pass rate."
• "What is our velocity trend over the last 4 sprints? What can we commit to Sprint 13?"
• "Prepare a PowerPoint deck for tomorrow's release committee call."
• "Publish the Sprint 12 retrospective notes to the wiki."

For developers & functional consultants:

• "What failed in the last pipeline run on main for repo api-gateway?"
• "Show me all open PRs assigned to me in the backend repository."
• "Find all code usages of TokenService across our repos."
• "Write the ADR for our new caching strategy to the Architecture wiki page."

For consultants working across customer tenants:

• "Add customer org contoso — I have guest access there."
• "Show me all my configured organisations and check which ones I can access."
• "Switch to the Fabrikam org and list their projects."
• "I'm now working on the Contoso engagement — use org contoso, project Finance."

---

Architecture

Five layers — left to right: who uses it → what skills handle it → how it connects → what ADO tools it calls → where the data lives. The PowerPoint output path (M365 only) branches off above the ADO layer.

flowchart LR

    %% ── LAYER 1 — USERS ────────────────────────────────────────────────────
    subgraph USERS["👥  Users"]
        direction TB
        PM(["🗂️  Project Manager\nSprint health · go/no-go\nvelocity · committee deck"])
        DEV(["💻  Developer\nPipelines · PRs\nbranches · code search"])
        FUNC(["📋  Functional Consultant\nBacklog · wiki\ntest plans · search"])
    end

    %% ── LAYER 2 — PLUGIN SKILLS ─────────────────────────────────────────────
    subgraph PLUGIN["🔌  ADO Cowork Plugin  —  11 SKILL.md files"]
        direction TB
        CTX["ado-context\nOrg & project selection\nsession context hub"]
        subgraph PMS["PM Skills  ★"]
            S1["ado-pm-reporting\nSprint health · go/no-go\nvelocity · retro · deck"]
            S2["ado-sprints-capacity"]
            S3["ado-work-items"]
            S4["ado-project-discovery"]
        end
        subgraph DEVS["Dev / All Skills"]
            S5["ado-pipelines"]
            S6["ado-repositories"]
            S7["ado-pull-requests"]
            S8["ado-test-plans"]
            S9["ado-search"]
            S10["ado-wiki"]
        end
        CTX -.->|"activeOrg\nactiveProject"| PMS & DEVS
    end

    %% ── LAYER 3 — DEPLOYMENT ────────────────────────────────────────────────
    subgraph DEPLOY["⚙️  Deployment options"]
        direction TB
        OA["A — Skills-only\nPrompts folder copy\nNo server needed"]
        OB["B — VS Code  mcp.json\ntype: http · Azure AD\nhttps://mcp.dev.azure.com/{org}"]
        OC["C — M365 Copilot\nmanifest.json\nauth: None"]
    end

    %% ── LAYER 4 — MCP SERVER ────────────────────────────────────────────────
    subgraph MCPSVR["☁️  Azure DevOps built-in MCP Server  (Microsoft-hosted · no provisioning)"]
        direction TB
        EP["https://mcp.dev.azure.com/{orgName}\nAzure AD auth"]
        subgraph TOOLS["~37 MCP tools"]
            direction LR
            T1["wit_*\nWork Items"]
            T2["pipelines_*\nCI/CD"]
            T3["repo_*\nRepos & PRs"]
            T4["testplan_*\nTest Plans"]
            T5["search_*\nCode · Wiki · WI"]
            T6["wiki_*\nWiki pages"]
            T7["work_* · core_*\nSprints · Projects"]
        end
        EP --> T1 & T2 & T3 & T4 & T5 & T6 & T7
    end

    %% ── LAYER 5 — ADO DATA ──────────────────────────────────────────────────
    subgraph ADO["🗄️  Azure DevOps Organisation"]
        direction TB
        D1["📋 Boards\n& Work Items"]
        D2["⚙️ Pipelines\n& Builds"]
        D3["🔀 Repos\n& Pull Requests"]
        D4["✅ Test Plans\n& Results"]
        D5["📖 Wikis\n& Pages"]
    end

    %% ── OUTPUT — M365 ONLY ──────────────────────────────────────────────────
    PPT["📊  PowerPoint deck\nOneDrive · SharePoint\nM365 Copilot only"]

    %% ── EDGES ───────────────────────────────────────────────────────────────
    PM & DEV & FUNC -->|"plain-English prompt"| PLUGIN
    PLUGIN --> OA & OB & OC
    OB -->|"HTTP · Azure AD"| EP
    OC -->|"HTTP · Azure AD (user session)"| EP
    OC -->|"create_presentation"| PPT
    T1 & T3 & T7 |"REST API"| D1
    T2 & T7     |"REST API"| D2
    T3          |"REST API"| D3
    T4          |"REST API"| D4
    T5          |"REST API"| D1 & D3 & D5
    T6          |"REST API"| D5

    %% ── STYLES ──────────────────────────────────────────────────────────────
    classDef user   fill:#1e3a5f,stroke:#4fa3e0,color:#cce5ff
    classDef pmsk   fill:#0d3068,stroke:#4fa3e0,color:#fff
    classDef devsk  fill:#1a2a3a,stroke:#4fa3e0,color:#cce5ff
    classDef deploy fill:#1e3a1e,stroke:#6abf69,color:#cfffce
    classDef ep     fill:#003366,stroke:#4fa3e0,color:#fff
    classDef tool   fill:#001a33,stroke:#4fa3e0,color:#99ccff
    classDef ado    fill:#005a9e,stroke:#4fa3e0,color:#fff
    classDef ppt    fill:#c43e1c,stroke:#e8814a,color:#fff
    class CTX ctx
    class PM,DEV,FUNC user
    class S1,S2,S3,S4 pmsk
    class S5,S6,S7,S8,S9,S10 devsk
    class OA,OB,OC deploy
    class EP ep
    class T1,T2,T3,T4,T5,T6,T7 tool
    class D1,D2,D3,D4,D5 ado
    class PPT ppt

> Rendered PNG: [architecture.png](architecture.png) — for attaching to emails, > presentations, and environments that do not render Mermaid inline.

---

Repository structure

ado-cowork-plugin/
├── manifest.json                          # M365 App Manifest v1.28 (Cowork package)
├── color.png                              # 192x192 plugin icon (color)
├── outline.png                            # 32x32 plugin icon (outline)
├── architecture.png                       # Rendered architecture diagram (PNG)
├── architecture.mmd                       # Mermaid source for architecture.png
├── package.ps1                            # ASKILL validation + ZIP packaging
├── README.md                              # This file
├── EXAMPLES.md                            # Usage examples with sample prompts
├── CHANGELOG.md
├── CONTRIBUTING.md
├── PRIVACY.md
├── SECURITY.md
├── LICENSE
└── skills/
    ├── ado-project-discovery/
    │   └── SKILL.md
    ├── ado-work-items/
    │   └── SKILL.md
    ├── ado-sprints-capacity/
    │   └── SKILL.md
    ├── ado-pipelines/
    │   └── SKILL.md
    ├── ado-repositories/
    │   └── SKILL.md
    ├── ado-pull-requests/
    │   └── SKILL.md
    ├── ado-test-plans/
    │   └── SKILL.md
    ├── ado-search/
    │   └── SKILL.md
    ├── ado-wiki/
    │   └── SKILL.md    ├── ado-context/
    │   └── SKILL.md    └── ado-pm-reporting/
        └── SKILL.md

---

Skills — Azure DevOps MCP tool coverage

| Skill | Audience | MCP tools covered | Use cases | |---|---|---|---| | ado-context | All | core_list_projects | Org & project selection, multi-project filtering, session context — used by all other skills | | ado-pm-reporting | PM | wit_query, wit_backlog, wit_work_item_write, work, work_iteration_write, work_capacity_write, pipelines_build, testplan_show_test_results_from_build_id, search_workitem, wiki_upsert_page | Sprint health, go/no-go, velocity, stakeholder updates, backlog grooming, retrospectives, PowerPoint decks | | ado-sprints-capacity | PM / Dev | work, work_capacity_write, work_iteration_write | Sprint setup, iteration management, team capacity | | ado-work-items | PM / Dev | wit_work_item, wit_work_item_write, wit_work_item_comment_write, wit_work_item_link_write, wit_work_item_attachment, wit_backlog, wit_query | Create/update PBIs, bugs, tasks; backlog queries | | ado-project-discovery | PM / All | core_list_projects, core_list_project_teams | Org structure, project list, team roster | | ado-pipelines | Dev | pipelines_build, pipelines_build_log, pipelines_run, pipelines_write, pipelines_definition, pipelines_artifact | Build status, logs, triggering runs, pipeline YAML | | ado-repositories | Dev | repo_repository, repo_branch, repo_create_branch, repo_file, repo_search_commits | Browse repos, files, branches, commit history | | ado-pull-requests | Dev | repo_pull_request, repo_pull_request_write, repo_pull_request_thread, repo_pull_request_thread_write | PR review, approval, comments, thread resolution | | ado-test-plans | Dev / QA | testplan, testplan_show_test_results_from_build_id, testplan_test_case_write, testplan_test_plan_write, testplan_test_suite_write | Test plan management, test case authoring, build results | | ado-search | All | search_code, search_wiki, search_workitem | Cross-project code/wiki/work item search | | ado-wiki | All | wiki, wiki_upsert_page | Read and write wiki pages |

---

Deployment options

| Option | Target | Auth | Effort | Licences required | |---|---|---|---|---| | A — Skills-only | Any AI assistant | None | Copy a folder | GitHub Copilot (any plan) + Azure DevOps Basic | | B — Local MCP | VS Code Copilot | Azure AD (auto) | Edit mcp.json | GitHub Copilot (any plan) + Azure DevOps Basic | | C — M365 Copilot | Whole M365 tenant | None (upgradable to OAuthPluginVault) | Admin upload | Microsoft 365 Copilot + Azure DevOps Basic + Frontier preview |

---

Licence requirements

Azure DevOps (required for all options)

Every user who calls ADO MCP tools needs access to the Azure DevOps organisation.

| ADO licence | What it covers | Minimum needed | |---|---|---| | Basic (free up to 5 users, then ~$6/user/mo) | Work items, boards, repos, pipelines, wikis | ✅ Sufficient for all plugin features | | Basic + Test Plans (~$52/user/mo) | All Basic features + test plan management | Only needed if using ado-test-plans skill | | Stakeholder (free, unlimited) | View/create work items only — no repo/pipeline access | ⚠ Partial — PM-only read workflows may work; dev skills will not | | Visual Studio subscriber | Included with VS Enterprise / Professional subscription | ✅ Fully covered |

> Guest users in a customer tenant: the guest still needs at least a Basic licence > (or Stakeholder) assigned in that organisation by the customer's ADO admin. Being a guest > in Azure AD is not enough on its own — ADO access level must be set separately.

---

Option A — Skills-only licence requirements

| Licence | Plan | Notes | |---|---|---| | GitHub Copilot | Individual, Business, or Enterprise | Any plan works; Business/Enterprise needed for org-managed policies | | Azure DevOps | Basic (or Stakeholder for read-only PM use) | No MCP calls are made — user pastes results manually; ADO web access is sufficient |

> Cost to start: GitHub Copilot Individual ($10/mo) + Azure DevOps Basic (free for ≤5 users). > Effectively free for small teams already on GitHub Copilot.

---

Option B — Local MCP licence requirements

| Licence | Plan | Notes | |---|---|---| | GitHub Copilot | Individual ($10/mo), Business ($19/user/mo), or Enterprise ($39/user/mo) | Agent mode (autonomous tool calls) requires VS Code 1.90+ with Copilot Chat | | Azure DevOps | Basic minimum | MCP tools make live REST API calls — Stakeholder access is insufficient for pipeline, repo, and test plan operations | | VS Code | Free | |

> Agent mode availability: GitHub Copilot agent mode (required for autonomous MCP > tool calls) is available on all paid Copilot plans in VS Code 1.90+.

---

Option C — M365 Copilot licence requirements ★ (recommended)

| Licence | SKU | Notes | |---|---|---| | Microsoft 365 Copilot | M365 Copilot add-on (~$30/user/mo) on top of M365 E3/E5 or Business Premium | Required for each end-user who will use the plugin | | Microsoft 365 E3 or E5 | or Microsoft 365 Business Premium | Base plan required — M365 Copilot is an add-on, not standalone | | Azure DevOps Basic | Included with Visual Studio subscriptions or ~$6/user/mo | Required for each ADO user — same as Options A/B | | M365 Global Admin or Teams Admin | Included in admin roles — no extra cost | Required once for the initial plugin upload to the Admin Centre |

> Existing M365 E3/E5 tenants: if your organisation already has M365 E3 or E5, > the only additional licence needed is the Microsoft 365 Copilot add-on per user.

> Visual Studio subscribers: VS Enterprise and VS Professional subscriptions include > an Azure DevOps Basic licence — no separate ADO licence purchase needed for those users.

Minimum licence set for a typical consulting team (Option C)

| Role | M365 Copilot | ADO licence | Notes | |---|---|---|---| | Project Manager | ✅ Required | Basic or Stakeholder | Stakeholder covers PM read/create WI workflows; Basic needed for full feature set | | Developer | ✅ Required | Basic | Full access to all skills | | Admin (setup only) | Optional | Not needed | Only needs M365 admin role to upload the plugin — no Copilot licence needed for the admin |

---

Licence comparison summary

| Feature | Skills-only (A) | Local MCP (B) | M365 Copilot (C) | |---|---|---|---| | Azure DevOps Basic | Required | Required | Required | | GitHub Copilot (any plan) | Required | Required | Not needed | | Microsoft 365 Copilot add-on | Not needed | Not needed | Required | | M365 E3/E5 or Business Premium | Not needed | Not needed | Required (base plan) | | VS Code | Required | Required | Not needed | | M365 Admin role | Not needed | Not needed | Required (one-time) | | Estimated per-user cost | ~$10–39/mo | ~$10–39/mo | ~$36–69/mo |

> Pricing is indicative (USD, as of 2026). Check the > Microsoft 365 pricing page > and Azure DevOps pricing page > for current rates in your region.

---

Option A — Skills-only (fastest, no server required)

Copy the skills/ folder into your VS Code prompts folder. The AI assistant follows the skill workflow and you paste ADO tool results manually.

• Supported by: GitHub Copilot, Claude Code, Cursor, Continue.dev, Gemini CLI, JetBrains Junie
• No additional setup required

.\package.ps1 -SkillsOnly   # copies skills/ to your VS Code prompts folder

---

Option B — Local MCP (fully autonomous, single user)

Connect VS Code to the Azure DevOps MCP server. The assistant calls tools autonomously.

Edit %APPDATA%\Code\User\mcp.json:

{
  "servers": {
    "ADO-MyOrg": {
      "url"

…

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [AurelienClere-365](https://github.com/AurelienClere-365)
- **Source:** [AurelienClere-365/ado-cowork-plugin](https://github.com/AurelienClere-365/ado-cowork-plugin)
- **License:** MIT
- **Homepage:** https://powerazure365.com

Install and usage instructions live in the source repository linked above.