ADO Attach icon

ADO Attach

Attach emails to Azure DevOps work items directly from Outlook. Works with the new Outlook, Outlook on the web, Mac, and classic desktop.

TypeScript React Fluent UI Office.js Azure DevOps API v7.1

What it does

Select one or more Azure DevOps work items by ID, and the current email is uploaded as an .eml attachment to each one. No copy-pasting, no manual downloads.

Install

Sideload in Outlook

  1. Download the manifest file using the button below.
  2. In Outlook (new or web), open any email.
  3. Go to Get Add-ins → My add-ins → Add a custom add-in → Add from file…
  4. Select the downloaded manifest.xml file.
Download manifest.xml

How to use

  1. Open an email you want to attach.
  2. Click "Attach to ADO" in the ribbon.
  3. On first use, configure your Azure DevOps org URL, project, and authentication.
  4. Enter a work item ID and click Add. Repeat for multiple items.
  5. Click Attach — done!

Authentication

Method Account type Setup
Personal Access Token Personal or work Generate a PAT with Work Items: Read & Write scope and paste it in settings.
Microsoft Entra ID Work / school only Sign in via popup. Requires an Azure App Registration.

Using a personal Microsoft account (@outlook.com, @hotmail.com, @gmail.com)? Use the PAT method.

View on GitHub