azure-devops-mcp

# ⭐ Azure DevOps MCP Server Easily install the Azure DevOps MCP Server for VS Code or VS Code Insiders: [](https://insiders.vscode.dev/redirect/mcp/install?name=ado&config=%7B%20%22type%22%3A%20%22stdio%22%2C%20%22command%22%3A%20%22npx%22%2C%20%22args%22%3A%20%5B%22-y%22%2C%20%22%40azure-devops%2Fmcp%22%2C%20%22%24%7Binput%3Aado_org%7D%22%5D%7D&inputs=%5B%7B%22id%22%3A%20%22ado_org%22%2C%20%22type%22%3A%20%22promptString%22%2C%20%22description%22%3A%20%22Azure%20DevOps%20organization%20name%20%20%28e.g.%20%27contoso%27%29%22%7D%5D) [](https://insiders.vscode.dev/redirect/mcp/install?name=ado&quality=insiders&config=%7B%20%22type%22%3A%20%22stdio%22%2C%20%22command%22%3A%20%22npx%22%2C%20%22args%22%3A%20%5B%22-y%22%2C%20%22%40azure-devops%2Fmcp%22%2C%20%22%24%7Binput%3Aado_org%7D%22%5D%7D&inputs=%5B%7B%22id%22%3A%20%22ado_org%22%2C%20%22type%22%3A%20%22promptString%22%2C%20%22description%22%3A%20%22Azure%20DevOps%20organization%20name%20%20%28e.g.%20%27contoso%27%29%22%7D%5D) This TypeScript project provides a **local** MCP server for Azure DevOps, enabling you to perform a wide range of Azure DevOps tasks directly from your code editor. ## 📄 Table of Contents 1. [📺 Overview](#-overview) 2. [🏆 Expectations](#-expectations) 3. [⚙️ Supported Tools](#️-supported-tools) 4. [🔌 Installation & Getting Started](#-installation--getting-started) 5. [🌏 Using Domains](#-using-domains) 6. [📝 Troubleshooting](#-troubleshooting) 7. [🎩 Examples & Best Practices](#-examples--best-practices) 8. [🙋‍♀️ Frequently Asked Questions](#️-frequently-asked-questions) 9. [📌 Contributing](#-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 from tools that are concise, simple, focused, and easy to use—each designed for a specific scenario. We intentionally avoid complex tools that try to do too much. The goal is to provide a thin abstraction layer over the REST APIs, making data access straightforward and letting the language model handle complex reasoning. ## ⚙️ Supported Tools See [TOOLSET.md](./docs/TOOLSET.md) for a comprehensive list. ## 🔌 Installation & Getting Started For the best experience, use Visual Studio Code and GitHub Copilot. See the [getting started documentation](./docs/GETTINGSTARTED.md) to use our MCP Server with other tools such as Visual Studio 2022, Claude Code, and Cursor. ### Prerequisites 1. Install [VS Code](https://code.visualstudio.com/download) or [VS Code Insiders](https://code.visualstudio.com/insiders) 2. Install [Node.js](https://nodejs.org/en/download) 20+ 3. Open VS Code in an empty folder ### Installation #### ✨ One-Click Install [](https://insiders.vscode.dev/redirect/mcp/install?name=ado&config=%7B%20%22type%22%3A%20%22stdio%22%2C%20%22command%22%3A%20%22npx%22%2C%20%22args%22%3A%20%5B%22-y%22%2C%20%22%40azure-devops%2Fmcp%22%2C%20%22%24%7Binput%3Aado_org%7D%22%5D%7D&inputs=%5B%7B%22id%22%3A%20%22ado_org%22%2C%20%22type%22%3A%20%22promptString%22%2C%20%22description%22%3A%20%22Azure%20DevOps%20organization%20name%20%20%28e.g.%20%27contoso%27%29%22%7D%5D) [](https://insiders.vscode.dev/redirect/mcp/install?name=ado&quality=insiders&config=%7B%20%22type%22%3A%20%22stdio%22%2C%20%22command%22%3A%20%22npx%22%2C%20%22args%22%3A%20%5B%22-y%22%2C%20%22%40azure-devops%2Fmcp%22%2C%20%22%24%7Binput%3Aado_org%7D%22%5D%7D&inputs=%5B%7B%22id%22%3A%20%22ado_org%22%2C%20%22type%22%3A%20%22promptString%22%2C%20%22description%22%3A%20%22Azure%20DevOps%20organization%20name%20%20%28e.g.%20%27contoso%27%29%22%7D%5D) After installation, select GitHub Copilot Agent Mode and refresh the t