mcp-devops-onpremise
An MCP server for on-prem Azure DevOps Server (TFS) that lets AI assistants read and write repositories, pull requests, work items, and wikis.
Browse repositories: list/get repos, view commit changes, diff commits/files, and read file content.
Review and manage pull requests: list/get PRs, inspect threads/comments, create/update PRs, manage reviewers/votes, and add/reply/update/delete comments.
Manage work items: get/search/query/create/update/delete/undelete, download attachments, inspect types, manage comments, and add/remove work item/artifact links.
Search code, work items, and wiki pages.
Manage wiki pages: get, create/update, update, and delete pages.
Authenticate to on-prem/VPN environments via NTLM, PAT, or OAuth bearer token, running locally without telemetry.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-devops-onpremise show open pull requests in the main repository"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Server for Azure DevOps Server (formerly TFS)
Model Context Protocol MCP server for Azure DevOps Server, formerly known as Team Foundation Server (TFS), the self-hosted, on-premises edition of Azure DevOps. It lets AI assistants browse repositories, review pull requests, manage work items, and interact with wikis.
Not for Azure DevOps Services (cloud,
dev.azure.com). For the cloud service, use Microsoft's official Azure DevOps MCP server.
Overview
Many organizations run Azure DevOps Server, formerly known as Team Foundation Server (TFS), on their own infrastructure. Integrating it with modern agentic AI tools and LLMs can be difficult. The official Microsoft Azure DevOps MCP server supports only the cloud-hosted Azure DevOps Services and is unlikely to support Azure DevOps Server in the future.
This MCP server closes that gap and enables smooth integration with Azure DevOps Server.
This project is under active development, with features continuously added to meet current requirements. Community needs are highly valued — if you miss any features, please submit an Issue. User-requested features are fast-tracked and will be prioritized and added as soon as possible.
Related MCP server: Azure DevOps MCP Server
Key Advantages
One of the most important features of this MCP server is NTLM authentication support. NTLM is required by many on-premises and enterprise environments where users authenticate with Windows domain credentials, either directly or over VPN. Most MCP servers for Azure DevOps target only cloud-hosted Azure DevOps Services with token-based auth and cannot connect to these environments.
NTLM authentication (Windows domain credentials) for on-prem and VPN-based setups where no other auth method works.
PAT and OAuth bearer token authentication as alternatives when available.
Enables secure access to Azure DevOps Server from MCP-compatible AI tools such as GitHub Copilot, Claude Desktop, Cursor, Windsurf, and others.
Works in restricted or offline environments without exposing sensitive data to external services.
Retrieves commit diffs with clear added/removed lines, similar to the Azure DevOps web UI.
Helps keep and track project documentation alongside code changes.
Automates common tasks such as work item management and code review processes.
Getting Started
Prerequisites
Python 3.10+ and uv are required. If not yet installed, see installation guide.
Quick Install
Click one of the buttons below to install directly in your IDE. You will be prompted for credentials:
For other platforms, see Manual Installation in the Getting Started guide.
Manual Installation
The MCP server can be installed manually in the following AI tools: VS Code, Visual Studio, Cursor, Goose, LM Studio, Amp, Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, Qodo Gen, Warp, Windsurf, GitHub Copilot CLI, GitHub Copilot Coding Agent, and others.
For step-by-step instructions, see Manual Installation in the Getting Started guide.
Claude Desktop
Install uv (one time). uv is the small helper program that starts this MCP server for Claude. You do not need administrator rights and you do not need to install Python: uv downloads Python itself when it is needed.
Windows: open PowerShell (Start menu, type
PowerShell, press Enter), paste the following line and press Enter:powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"macOS / Linux: open a terminal and run
curl -LsSf https://astral.sh/uv/install.sh | sh.
Open the Claude Desktop configuration file. In Claude Desktop, open Settings (usually by clicking your name in the lower left corner), go to Desktop app, click Manage next to Extensions, and under Local MCP servers click Edit config. A folder opens that contains the file
claude_desktop_config.json.Open the file in a text editor (for example right-click the file → Open with → Notepad). The first line contains only
{. Add an empty line below it and paste one of the following blocks there, depending on how you log in to Azure DevOps Server. Then replace the example values in quotes with your own (DEVOPS_API_URLis the address of your project, e.g.https://devops.mycompany.com/MyOrg/MyProject).Login with Windows user name and password (NTLM):
"mcpServers": { "devops-onprem": { "command": "uvx", "args": ["mcp-devops-onpremise@latest"], "env": { "DEVOPS_API_URL": "https://your-devops-server/your-organization/your-project", "DEVOPS_USERNAME": "DOMAIN\\your-username", "DEVOPS_PASSWORD": "your-password" } } },Login with a personal access token (PAT):
"mcpServers": { "devops-onprem": { "command": "uvx", "args": ["mcp-devops-onpremise@latest"], "env": { "DEVOPS_API_URL": "https://your-devops-server/your-organization/your-project", "DEVOPS_PAT": "your-personal-access-token" } } },Keep the comma after the closing
}of the block you pasted. The file usually contains more settings below it, and the comma separates them. Only if the file consists of nothing but{}, remove that comma. If the file already has an"mcpServers"section, do not paste a second one: add only the"devops-onprem": { ... }part inside the existing section, separated by a comma from the other entries.Save the file and restart Claude Desktop completely: quit it (also via the icon in the system tray next to the clock) and start it again. This restart is required, even if Claude Desktop was open while you installed uv, because only a freshly started Claude Desktop finds
uvx.Check: the server
devops-onpremis now listed under Local MCP servers. If it shows an error, see Troubleshooting.
More details: Getting Started.
Configuration
The DEVOPS_API_URL must point to your full project URL:
https://<your-devops-server>/<organization>/<project>The server supports three authentication methods. If you are unsure which one to use, start with NTLM because it is the most common for on-prem/VPN setups.
Method | Description |
NTLM (username + password) | Most common for on-prem/VPN. Usually the simplest first setup and best fallback if other options fail. |
PAT (Personal Access Token) | Use when PAT is enabled and allowed. Tokens can expire, and token-based auth may be blocked by policy. Advantage: you do not store your account password in config. |
OAuth Bearer Token | Advanced option for CI/CD pipelines. Requires OAuth 2.0 configured on your Azure DevOps Server and a token source defined by your administrators. |
For detailed setup instructions for each method, see Authentication in the Getting Started guide.
With NTLM (username + password)
{
"mcpServers": {
"devops-onprem": {
"command": "uvx",
"args": ["mcp-devops-onpremise@latest"],
"env": {
"DEVOPS_API_URL": "https://your-devops-server/your-organization/your-project",
"DEVOPS_USERNAME": "DOMAIN\\your-username",
"DEVOPS_PASSWORD": "your-password"
}
}
}
}With PAT
{
"mcpServers": {
"devops-onprem": {
"command": "uvx",
"args": ["mcp-devops-onpremise@latest"],
"env": {
"DEVOPS_API_URL": "https://your-devops-server/your-organization/your-project",
"DEVOPS_PAT": "your-personal-access-token"
}
}
}
}If you used a permanent install, replace
"command": "uvx"with"command": "mcp-devops-onpremise"and remove the"args"line.
Claude plugin
The claude-plugin/ folder packages this server as a Claude plugin (Claude Code, Claude Desktop/Cowork). It launches the pinned PyPI release with uvx and asks for the project URL and credentials when you enable it; passwords and tokens are stored in the system's secure credential store. See claude-plugin/README.md.
The plugin pins an exact version (uvx mcp-devops-onpremise==X.Y.Z) and is updated automatically through the Claude plugin directory with every release. Manual configurations like the examples above use @latest, which uvx resolves to the newest release on every start.
Updating
All configuration examples use mcp-devops-onpremise@latest, which instructs uvx to fetch the latest version automatically on every run.
For permanent installs and release notes, see Updating in the Getting Started guide.
Available Tools
Pull Requests
Tool | Description | Read-only |
| List pull requests of a repository, filtered by status, target branch, and creation and/or closing time, with paging | ✅ |
| Retrieve a pull request by ID, including author, reviewers, merge status, linked work items, and commit SHAs for diffing | ✅ |
| Create or update pull requests, update reviewers, or cast your PR vote | ❌ |
| Returns a hierarchical list of non-deleted comment threads and their text comments | ✅ |
| List non-deleted text comments in a specific thread | ✅ |
| Create a new thread with an initial comment (general or inline on a file/line) | ❌ |
| Reply to an existing comment thread | ❌ |
| Update the status of a comment thread | ❌ |
| Update the text of an existing comment | ❌ |
| Delete a comment from a pull request thread | ❌ |
Repositories
Tool | Description | Read-only |
| List all repositories in the project | ✅ |
| Retrieve repository details by name or ID | ✅ |
| List files changed in a specific commit | ✅ |
| Get the difference between two commits (changed file paths) | ✅ |
| Get raw file content at a specific commit or branch | ✅ |
| Get line-level textual diff of a file between two commits (added lines prefixed | ✅ |
Work Items
Tool | Description | Read-only |
| Retrieve a work item (PBI, bug, task) by numeric ID. Returns a compact object with key fields, attachments (files and inline images), and linked items (work items, pull requests, commits) | ✅ |
| Download a work item attachment by its GUID, either saving locally or returning base64-encoded content | ✅ |
| Get the definition of a work item type by name (e.g. | ✅ |
| Execute a WIQL (Work Item Query Language) query and return matching work items | ✅ |
| Create a new work item with typed fields; Html is the default format | ❌ |
| Update fields on a work item using JSON Patch (add / replace / remove) | ❌ |
| Delete a work item, moves to Recycle Bin by default; use | ❌ |
| Restore a soft-deleted work item from the Recycle Bin | ❌ |
| Add or remove a relation link between two work items (parent, child, related, successor, predecessor, etc.) | ❌ |
| Add or remove an artifact link (Pull Request, Build, Commit, Branch, Changeset) on a work item | ❌ |
| List comments on a work item with configurable page size and format | ✅ |
| Add a comment to a work item | ❌ |
| Update an existing comment on a work item | ❌ |
| Delete a comment from a work item | ❌ |
Search
Tool | Description | Read-only |
| Search source code with optional repository, path, and branch filters | ✅ |
| Search work items with optional area, type, state, and assigned-to filters | ✅ |
| Search wiki pages with an optional wiki filter | ✅ |
Wiki
Tool | Description | Read-only |
| Get wiki page metadata and optional content by wiki ID and page ID | ✅ |
| Create or update a wiki page under a specified parent page | ❌ |
| Update an existing wiki page by ID | ❌ |
| Delete an existing wiki page by ID | ❌ |
Privacy Policy
The server runs locally and talks only to the Azure DevOps Server URL you configure. It collects no telemetry and stores no data, apart from attachment files you explicitly ask it to save. Full policy: PRIVACY.md.
Development
# Install dev dependencies
uv sync --group dev
# Run linting
uv run ruff check src/
uv run black --check src/
# Run tests
uv run pytest tests/To publish a new version, see Releasing.
Community project, not affiliated with or endorsed by Microsoft. Azure DevOps is a trademark of Microsoft.
Available Tools
37 toolsdevops_code_searchSearch codeBRead-only
Search source code in the configured Azure DevOps project. Returns matching file locations with snippet context. Optionally filter by repository, path, and branch.
Inputs: search_text (required), top, path, skip, +3 more. Returns: Generic wrapper for non-object return types.
devops_get_item_content_diffGet file diffARead-only
Get textual diff between two versions of a file (changed hunks only). Lines are numbered; added lines are prefixed with '+', and removed with '-'. For full content of specific file, use item content tool with target version .
Inputs: path (required), base_version (required), repository_id (required), target_version (required). Returns: Generic wrapper for non-object return types.
devops_pull_request_create_commentCreate pull request commentA
Create a new thread with initial comment in the specified pull request.
Inputs: repository_id (required), comment_content (required), pull_request_id (required), file_path, +1 more. Returns: Generic wrapper for non-object return types.
devops_pull_request_delete_commentDelete pull request commentCDestructive
Delete a comment from the specified pull request.
Inputs: thread_id (required), comment_id (required), repository_id (required), pull_request_id (required).
devops_pull_request_getGet pull requestARead-only
Retrieve a pull request by ID, including author, reviewers, merge status, closing date, and linked work items. Use the 'lastMergeTargetCommit' and 'lastMergeSourceCommit' from the result to obtain changes with 'devops_repository_diffs_commits' tool.
Inputs: repository_id (required), pull_request_id (required). Returns: Generic wrapper for non-object return types.
devops_pull_request_listList pull requestsARead-only
List pull requests of a repository, optionally filtered by status, target branch, and a time range. 'min_time'/'max_time' filter on the creation time by default, or on the closing time when 'time_range_type' is 'closed' (completed pull requests only). Supports paging with 'top' and 'skip'. Use 'devops_pull_request_get' with a returned 'prId' for details.
Inputs: repository_id (required), top, skip, status, +4 more. Returns: Generic wrapper for non-object return types.
devops_pull_request_list_thread_commentsList pull request thread commentsBRead-only
Retrieves a list of non-deleted text comments in a specific thread.
Inputs: thread_id (required), repository_id (required), pull_request_id (required). Returns: Generic wrapper for non-object return types.
devops_pull_request_list_threadsList pull request threadsBRead-only
Retrieve a hierarchical list of non-deleted comment threads and their text comments for a pull request.
Inputs: repository_id (required), pull_request_id (required). Returns: Generic wrapper for non-object return types.
devops_pull_request_reply_commentReply to pull request commentC
Replies to a specific comment on a pull request.
Inputs: thread_id (required), repository_id (required), comment_content (required), pull_request_id (required). Returns: Generic wrapper for non-object return types.
devops_pull_request_update_commentUpdate pull request commentCDestructive
Update an existing comment in the specified pull request.
Inputs: thread_id (required), comment_id (required), repository_id (required), comment_content (required), +2 more. Returns: Generic wrapper for non-object return types.
devops_pull_request_update_threadUpdate pull request thread statusCDestructive
Update the status of a comment thread.
Inputs: status (required), thread_id (required), repository_id (required), pull_request_id (required). Returns: Generic wrapper for non-object return types.
devops_pull_request_writeCreate or update pull requestADestructive
Write operations for pull requests. Use the action parameter to create or update pull requests, add or remove reviewers, or cast the authenticated user's vote.
Inputs: action (required), vote, title, labels, +18 more. Returns: Generic wrapper for non-object return types.
devops_repository_commit_changesGet commit changesBRead-only
Retrieve a list of files changed in the specified commit, including the type of change for each file (e.g., add, edit, remove).
Inputs: commit_id (required), repository_id (required). Returns: Generic wrapper for non-object return types.
devops_repository_diffs_commitsDiff two commitsCRead-only
Get the difference between the base and target commits.
Inputs: base_commit (required), repository_id (required), target_commit (required). Returns: Generic wrapper for non-object return types.
devops_repository_getGet repositoryARead-only
Retrieve repository details by repository name or ID.
Inputs: repository_id (required). Returns: Generic wrapper for non-object return types.
devops_repository_item_contentGet file contentBRead-only
Get raw file content for a repository path at a specific version.
Inputs: path (required), version (required), repository_id (required). Returns: Generic wrapper for non-object return types.
devops_repository_listList repositoriesCRead-only
Get the list of repositories.
Inputs: no named parameters. Returns: Generic wrapper for non-object return types.
devops_wiki_page_create_or_updateCreate or update wiki pageBDestructive
Create or update a wiki page under the specified parent page.
Inputs: title (required), wiki_id (required), parent_path (required), content. Returns: Generic wrapper for non-object return types.
devops_wiki_page_deleteDelete wiki pageCDestructive
Delete an existing wiki page.
Inputs: page_id (required), wiki_id (required), comment.
devops_wiki_page_getGet wiki pageARead-only
Retrieves metadata (path, isParentPage) and/or content of a wiki page. The wiki_id and page_id are found in the browser URL: https://.../_wiki/wikis/{wiki_id}/{page_id}/...
Inputs: page_id (required), wiki_id (required), include_content. Returns: Generic wrapper for non-object return types.
devops_wiki_page_updateUpdate wiki pageCDestructive
Update an existing wiki page.
Inputs: page_id (required), wiki_id (required), content. Returns: Generic wrapper for non-object return types.
devops_wiki_searchSearch wikiARead-only
Search wiki pages in the configured Azure DevOps project. Returns matching pages with snippet context. Optionally filter by wiki name.
Inputs: search_text (required), top, skip, wiki, +1 more. Returns: Generic wrapper for non-object return types.
devops_work_item_artifact_link_updateAdd or remove work item artifact linkADestructive
Add or remove an artifact link (Pull Request, Build, Commit, Branch, Changeset, Versioned Item) on a work item. Use op='add' (default) to attach, op='remove' to detach. The artifact_id format depends on link_type (see parameter doc).
Inputs: link_type (required), artifact_id (required), work_item_id (required), op, +2 more. Returns: Generic wrapper for non-object return types.
devops_work_item_attachment_getGet work item attachmentADestructive
Download a work item attachment by specified ID. Returns base64-encoded content, or saves to a local directory if savePath is provided.
Inputs: file_name (required), attachment_id (required), save_path. Returns: Generic wrapper for non-object return types.
devops_work_item_comment_addAdd work item commentC
Add a comment to a work item.
Inputs: text (required), work_item_id (required), format. Returns: Generic wrapper for non-object return types.
devops_work_item_comment_deleteDelete work item commentCDestructive
Delete a comment from a work item.
Inputs: comment_id (required), work_item_id (required). Returns: Generic wrapper for non-object return types.
devops_work_item_comment_listList work item commentsBRead-only
List comments on a work item. Returns up to top comments (default 50).
Inputs: work_item_id (required), top, format. Returns: Generic wrapper for non-object return types.
devops_work_item_comment_updateUpdate work item commentBDestructive
Update an existing comment on a work item.
Inputs: text (required), comment_id (required), work_item_id (required), format. Returns: Generic wrapper for non-object return types.
devops_work_item_createCreate work itemC
Create a new work item of the specified work item type.
Inputs: type (required), fields (required), validate_only. Returns: Generic wrapper for non-object return types.
devops_work_item_deleteDelete work itemADestructive
Delete a work item by ID. By default the item is sent to the Recycle Bin and can be restored. Set destroy=True to permanently destroy the item — WARNING: this is irreversible.
Inputs: work_item_id (required), destroy. Returns: Generic wrapper for non-object return types.
devops_work_item_getGet work itemARead-only
Retrieve a single work item by numeric ID. Returns a compact object with key fields (title, state, type, assignee, description, acceptance criteria, tags, parent), plus attachments (files and inline images) and linked items (work items, pull requests, commits).
Inputs: work_item_id (required). Returns: Generic wrapper for non-object return types.
devops_work_item_link_updateAdd or remove work item linkADestructive
Add or remove a relation link between two work items. Use op='add' (default) to create a new link, op='remove' to delete an existing one. To change a link type, call remove then add.
Inputs: link_to_id (required), work_item_id (required), op, comment, +2 more. Returns: Generic wrapper for non-object return types.
devops_work_item_query_by_wiqlQuery work items (WIQL)CRead-only
Execute a WIQL (Work Item Query Language) query and return the matching work items.
Inputs: query (required), top, time_precision. Returns: Generic wrapper for non-object return types.
devops_work_item_searchSearch work itemsARead-only
Search work items (PBIs, bugs, tasks, etc.) in the configured Azure DevOps project using full-text search. Optionally filter by area path, work item type, state, or assigned-to user.
Inputs: search_text (required), top, skip, state, +4 more. Returns: Generic wrapper for non-object return types.
devops_work_item_type_getGet work item typeBRead-only
Get definition for the specified work item type.
Inputs: type (required). Returns: Generic wrapper for non-object return types.
devops_work_item_undeleteRestore deleted work itemA
Restore a work item from the Recycle Bin by ID. Only works for items deleted without the destroy flag.
Inputs: work_item_id (required). Returns: Generic wrapper for non-object return types.
devops_work_item_updateUpdate work itemCDestructive
Update fields on a work item by ID.
Inputs: updates (required), work_item_id (required), validate_only. Returns: Generic wrapper for non-object return types.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 37 tools
Most tools are cleanly separated by domain (repository, pull request, wiki, work item) and action. Minor ambiguity exists between devops_wiki_page_create_or_update and devops_wiki_page_update, and devops_pull_request_write is a broad multi-action tool that partly overlaps with dedicated PR tools.
The set mostly follows a consistent devops_<domain>_<entity>_<action> pattern, with clear prefixes and readable verbs. A few deviations exist, such as devops_get_item_content_diff, devops_repository_diffs_commits, and the generic devops_pull_request_write.
37 tools is high for an MCP server surface and exceeds the typical well-scoped range. The breadth is somewhat justified by covering four Azure DevOps areas, but several CRUD/comment tools could likely be consolidated.
Core work item, wiki, pull request, and repository-read workflows are well covered, with CRUD operations in several areas. However, notable gaps remain for a general on-premise DevOps server, including repository write/branch operations, pipelines/builds/releases, and project/team administration.
Maintenance
Related MCP Connectors
The MCP server for Azure DevOps, bringing the power of Azure DevOps directly to your agents.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
Related MCP Servers
- AlicenseBqualityDmaintenanceA read-only MCP server connecting AI assistants to Azure DevOps Server (on-premises) for browsing projects, repos, builds, work items, releases, pipelines, and test results.391MIT
- AlicenseAqualityDmaintenanceAn MCP server that exposes 41 Azure DevOps tools to AI assistants, enabling management of pipelines, repositories, pull requests, releases, work items, test management, and wikis through natural language.4139 PyPIMIT
- AlicenseNot gradedqualityCmaintenanceMCP server that enables AI assistants to manage Azure DevOps resources including Work Items, Git repositories, pipelines, and user identities.MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for Azure DevOps Server 2022 (on-premises) that enables AI assistants to interact with work items, repositories, builds, and sprints through 29 tools.9 npmMIT