azure-devops-mcp

MCP.Pizza Chef: microsoft

Once connected, your assistant can look up Azure DevOps projects, track and update work items, review pull requests, browse code repositories, and read or edit project wiki pages without you switching to a browser. It works inside Visual Studio Code and Cursor, either through a ready-to-use hosted connection that needs no installation, or a local setup that runs through Node.js. You don't need any special account set up in advance — you just sign in with your existing Microsoft account the first time you use it.

Coding
Data
Notes

Use This MCP server To

List all my Azure DevOps projects at a glance See which work items are assigned to me Check the status of a recent build Browse the files in a code repository Create or update a project wiki page Review open pull requests before merging See what's planned for the current sprint

README

⭐ Azure DevOps MCP Server

Warning

We recently completed a full tool consolidation that includes renaming of existing tools. Please see the Toolset documentation for the complete list of new tool names.

If this is a breaking change for your agents or skills, you can temporarily pin the version to @azure-devops/mcp@2.8.1

This project provides Azure DevOps MCP tooling for AI agents, with a remote-first onboarding experience and a local server option when you need it.

📄 Table of Contents

Important

We recommend using the Remote MCP Server instead of this local server. It requires no installation and gets new features first.

Learn more

  1. 📺 Overview
  2. 🏆 Expectations
  3. 🚀 Remote MCP Server (Recommended)
  4. ⚙️ Supported Tools
  5. 🔌 Local MCP Server Installation (Optional)
  6. 🌏 Using Domains (local)
  7. 🐥 Project and Team Defaults (local)
  8. 📝 Troubleshooting
  9. 🎩 Examples & Best Practices
  10. 🙋‍♀️ Frequently Asked Questions
  11. 📌 Contributing

📺 Overview

The Azure DevOps MCP Server brings Azure DevOps context to your agents. Try prompts like:

  • "List my ADO projects"
  • "List ADO Builds for 'Contoso'"
  • "List ADO Repos for 'Contoso'"
  • "List test plans for 'Contoso'"
  • "List teams for project 'Contoso'"
  • "List iterations for project 'Contoso'"
  • "List my work items for project 'Contoso'"
  • "List work items in current iteration for 'Contoso' project and 'Contoso Team'"
  • "List all wikis in the 'Contoso' project"
  • "Create a wiki page '/Architecture/Overview' with content about system design"
  • "Update the wiki page '/Getting Started' with new onboarding instructions"
  • "Get the content of the wiki page '/API/Authentication' from the Documentation wiki"

🏆 Expectations

The Azure DevOps MCP Server is built around tools that are concise, simple, focused, and easy to use, with each one designed for a specific scenario. We intentionally avoid creating complex tools that try to do too much. The goal is to provide a thin abstraction layer over the REST APIs that makes data access straightforward while allowing the language model to handle the more complex reasoning.

azure-devops-mcp FAQ

Can I use this to check my Azure DevOps work items without opening a browser?
Yes — you can ask your assistant to list, review, or update the work items assigned to you, pulling the current details straight from Azure DevOps into your conversation.
Can I use this to review pull requests before I merge them?
Yes — you can ask your assistant to show you open pull requests and summarize the changes so you can decide whether they're ready to merge.
Which apps does this work in?
It's built to work with Visual Studio Code and Cursor, and its setup guide also covers other AI coding assistants such as Claude Code and OpenAI's Codex.
Do I need to sign up for anything or get a special key first?
No advance sign-up is required. The first time you use it, a browser window opens and asks you to log in with your existing Microsoft account.
How hard is this to set up?
It's a short one-time setup — you paste a small connection snippet into a configuration file in your editor and type in your Azure DevOps organization name, with no coding required.
Can I use this to update a project's wiki pages?
Yes — you can ask your assistant to create a new wiki page or update an existing one, such as adding onboarding notes or refreshing a design document.
Can I track sprint or iteration progress with this?
Yes — you can ask your assistant to list your team's current work items, sprints, or iterations so you can check progress without opening the Azure DevOps website.
Will my assistant be able to see private company data it shouldn't?
It only shows the Azure DevOps projects and organizations you already have access to under your own sign-in, so your assistant sees exactly what you can see and nothing more.