
Azure DevOps MCP Server by Tiberriver256: Setup for Claude, Cursor and More
Not the official Azure DevOps MCP server. This one is built by the community. Azure DevOps makes its own: Azure DevOps (ADO) →
Lets Claude, Cursor and other assistants work with Azure DevOps repos, pull requests, pipelines, wikis and work items.
This is a community Azure DevOps server by Tiberriver256, not Microsoft's. It lets your assistant read repos and code, review and open pull requests, check and start pipelines, edit wikis and manage work items.
It runs on your computer. You sign in with a personal access token, your Azure login or the Azure CLI. On-premises Azure DevOps Server works only with a token. Microsoft's own server is the better first choice for Azure DevOps Services in the cloud.
It can commit code, start pipelines and edit work items. Use a token with only the scopes you need.
Good for
- Teams on Azure DevOps Server (on-premises) who need a server Microsoft's may not support
- Developers who want PRs, pipelines and work items handled from their editor
- Engineering leads who triage work items and track builds by chat
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install mcp-server-azure-devops
Claude Code
- 1
Copy this prompt.
Add the mcp-server-azure-devops server to Claude Code. Run this command: claude mcp add azure-devops -e AZURE_DEVOPS_ORG_URL=<AZURE_DEVOPS_ORG_URL> -- npx -y @tiberriver256/mcp-server-azure-devops Ask me for AZURE_DEVOPS_ORG_URL and only put the values in that config, nowhere else. Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js.
Built from the package data we hold. Not yet tested by us.
Tools
Lists your Azure DevOps organizations
Lists the organizations your sign-in can reach.
Try: “Which Azure DevOps organizations can I use?”
Network ·
list_organizationsLists projects
Lists the projects in an organization.
Try: “List the projects in our organization.”
Network ·
list_projectsShows one project
Returns the basic details of a project.
Try: “Show me the Payments project.”
Network ·
get_projectShows process, work item types and teams
Returns a project with its process, work item types and teams.
Try: “What work item types and teams does Payments have?”
Network ·
get_project_detailsLists repositories
Lists the Git repositories in a project.
Try: “What repos are in Payments?”
Network ·
list_repositoriesShows one repository
Returns the details of one repository.
Try: “Show me the api-gateway repo.”
Network ·
get_repositoryShows repository stats and branches
Returns a repository with statistics and its branches and tags.
Try: “Give me stats and branches for api-gateway.”
Network ·
get_repository_detailsReads a file or folder
Returns the content of a file, or the listing of a folder, from a repository branch.
Try: “Read src/index.ts on main in api-gateway.”
Network ·
get_file_contentShows a repo as a tree
Shows the folders and files of one repository, starting from an optional path.
Try: “Show the folder structure of api-gateway.”
Network ·
get_repository_treeShows the trees of all repos in a project
Shows the folder tree of every repository in a project on its default branch.
Try: “Show me the layout of every repo in Payments.”
Network ·
get_all_repositories_treeCreates a branch
Creates a new branch from an existing one.
Try: “Create branch fix/login-bug from main.”
Write ·
create_branchCommits file changes to a branch
Commits file changes to an existing branch. Changes can be a search and replace of exact text or a full file.
Try: “Commit a fix to src/auth.ts on fix/login-bug.”
Write ·
create_commitLists recent commits with diffs
Lists recent commits on a branch, with the file changes of each.
Try: “What changed on main this week?”
Network ·
list_commitsOpens a pull request
Opens a pull request with reviewers, linked work items and optional tags.
Try: “Open a PR from fix/login-bug to main and link task 412.”
Write ·
create_pull_requestShows a pull request
Returns a pull request by its number. It works without the repository, which suits Azure DevOps Server.
Try: “Show me pull request 87.”
Network ·
get_pull_requestLists pull requests
Lists the pull requests of a repository.
Try: “List open PRs in api-gateway.”
Network ·
list_pull_requestsReads PR comments
Returns the comment threads on a pull request.
Try: “What did reviewers say on PR 87?”
Network ·
get_pull_request_commentsComments on a pull request
Adds a comment to a pull request.
Try: “Comment on PR 87 that tests pass locally.”
Write ·
add_pull_request_commentEdits a pull request
Changes a pull request: its text, reviewers, linked work items and tags.
Try: “Add Dana as a reviewer on PR 87.”
Write ·
update_pull_requestShows files and diffs of a PR
Returns the files a pull request changes, their diffs, the branches and the status of policy checks.
Try: “Summarize the changes in PR 87.”
Network ·
get_pull_request_changesSummarizes PR checks
Summarizes the latest status checks and policy results for a pull request, with the pipeline runs behind them.
Try: “Why is PR 87 blocked?”
Network ·
get_pull_request_checksResolves or reopens a PR thread
Changes the status of a comment thread on a pull request.
Try: “Resolve the thread about naming on PR 87.”
Write ·
update_pull_request_thread_statusLists pipelines
Lists the pipelines in a project.
Try: “What pipelines does Payments have?”
Network ·
list_pipelinesShows one pipeline
Returns the details of a pipeline.
Try: “Show me the build pipeline.”
Network ·
get_pipelineLists recent pipeline runs
Lists recent runs of a pipeline.
Try: “Show the last 10 runs of the build pipeline.”
Network ·
list_pipeline_runsShows one pipeline run
Returns the details of a single pipeline run.
Try: “Show me run 5521.”
Network ·
get_pipeline_runShows stages and jobs of a run
Returns the stages and jobs of a run. You can filter by state and result to keep the answer short.
Try: “Which jobs failed in run 5521?”
Network ·
pipeline_timelineReads a pipeline log
Returns one log from a run, found by its id in the timeline.
Try: “Show the log of the failed test job.”
Network ·
get_pipeline_logReads a file from a run artifact
Downloads a file from a pipeline run artifact and returns it as text.
Try: “Read results.xml from run 5521.”
Network ·
download_pipeline_artifactStarts a pipeline run
Starts a run of a pipeline. That can build, test or deploy depending on the pipeline.
Try: “Run the build pipeline on main.”
Runs code ·
trigger_pipelineSearches code
Searches code across the repositories of a project.
Try: “Find where RetryPolicy is used.”
Network ·
search_codeSearches wikis
Searches the wiki pages of a project.
Try: “Search the wiki for onboarding.”
Network ·
search_wikiSearches work items
Searches work items across projects.
Try: “Find work items mentioning timeout.”
Network ·
search_work_itemsShows who you are signed in as
Returns your id, name and email in Azure DevOps.
Try: “Who am I in Azure DevOps?”
Network ·
get_meLists wikis
Returns the wikis of a project.
Try: “What wikis does Payments have?”
Network ·
get_wikisReads a wiki page
Returns the content of a wiki page.
Try: “Read the Deployment page in the wiki.”
Network ·
get_wiki_pageLists wiki pages
Lists the pages inside a wiki.
Try: “List pages in the Payments wiki.”
Network ·
list_wiki_pagesCreates a wiki
Creates a new wiki in a project.
Try: “Create a wiki for Payments.”
Write ·
create_wikiCreates a wiki page
Creates a page in a wiki, and updates the page if one already exists at that path.
Try: “Create a Runbook page in the wiki.”
Write ·
create_wiki_pageEdits a wiki page
Replaces the content of a wiki page.
Try: “Update the Deployment page with the new steps.”
Write ·
update_wiki_pageLists work items
Lists the work items in a project.
Try: “List open bugs in Payments.”
Network ·
list_work_itemsShows one work item
Returns the details of a work item.
Try: “Show me work item 412.”
Network ·
get_work_itemCreates a work item
Creates a new work item such as a bug or task.
Try: “Create a bug "Login fails on Safari".”
Write ·
create_work_itemEdits a work item
Changes the fields of a work item.
Try: “Assign work item 412 to Dana.”
Write ·
update_work_itemAdds or removes work item links
Adds or removes links between work items.
Try: “Link work item 412 as a child of 300.”
Write ·
manage_work_item_linkReads work item comments
Returns the comments and discussion on a work item.
Try: “What was discussed on work item 412?”
Network ·
get_work_item_commentsAttaches a local file to a work item
Reads a file from your computer, uploads it and links it to a work item.
Try: “Attach ./trace.log to work item 412.”
Write ·
create_work_item_attachmentDownloads an attachment to disk
Downloads an attachment from a work item and saves it on your computer.
Try: “Download the screenshot from work item 412.”
Write ·
get_work_item_attachmentDeletes a work item attachment
Removes an attachment from a work item.
Try: “Remove the old log from work item 412.”
Delete ·
delete_work_item_attachment
Read from the source code
Permissions
high risk · 5 things to watch
High risk
The assistant can read your repos and change them: it can commit code, open pull requests, start pipelines and edit work items. Give it a personal access token with the narrowest scopes that do the job.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It can start pipelines
trigger_pipeline starts a run, which may build or deploy to real environments. Use a token without build execute rights unless you want that. github.com
It can commit code and open PRs
create_commit, create_branch and create_pull_request change your repositories. Protect your main branch with policies so changes need review. github.com
It can edit work items and wikis
Work item and wiki tools create and overwrite content, and create_wiki_page replaces a page that already exists. Check changes before you approve them. github.com
It can delete work item attachments
delete_work_item_attachment removes a file from a work item. Review the target before approving. github.com
It reads and writes local files
create_work_item_attachment reads a file from your computer and get_work_item_attachment saves a file to it. Check the paths. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | No read-only switch was found in the published package. Limit what the assistant can do by giving it a personal access token with read-only scopes. |
|---|---|
| Talks to | Your Azure DevOps organization (dev.azure.com or your server) |
| Sign-in and keys | A personal access token sits in AZURE_DEVOPS_PAT in your app config. Azure Identity and Azure CLI sign-in use your existing Azure login instead. |
| Scopes |
|
Questions
Is this the official Azure DevOps MCP server?
No. It is a community project by Tiberriver256. Microsoft maintains its own server, which the README recommends for Azure DevOps Services in the cloud. See Azure DevOps (local) or the hosted one.
When should I pick this one over Microsoft's?
Pick it for Azure DevOps Server on-premises, especially older versions that may not work with Microsoft's server, or for features Microsoft's does not have yet. Otherwise start with Microsoft's.
How do I sign in?
With a personal access token, Azure Identity or the Azure CLI, chosen by the auth method setting. Azure DevOps Server supports only the token. Azure Identity is the default.
Which scopes does the token need?
That depends on the tools you use. Read tools need read scopes for code, work items, build, wiki and pull requests. Write tools need the matching write scopes, so a read-only token keeps the assistant read-only.
Can it run in read-only mode?
Not with a switch in the published package. Use a token with read-only scopes, and the write calls fail.
Does it work with Azure DevOps Server on-premises?
Yes, with a personal access token only. Set AZURE_DEVOPS_ORG_URL to your collection address, for example https://server:8080/tfs/DefaultCollection, set AZURE_DEVOPS_AUTH_METHOD to pat and put the token in AZURE_DEVOPS_PAT.
Which AI apps does it work with?
It runs locally with npx over stdio, so it works with Claude Code, Claude Desktop, Cursor, VS Code and other apps that start local servers. Use the install box.
Information
updated Nov 2, 2026
- Publisher
- Community
- Package
@tiberriver256/mcp-server-azure-devops- Registry
- npm
- Transport
- stdio
- Auth
- token in env
- Version
- 0.1.53
- License
- MIT
- Last commit
- Oct 31, 2026
- Open issues
- 12
Other Azure DevOps MCP servers
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 2Hide
- www.npmjs.com · npmjs.com
- github.com · github.com