Azure DevOps MCP Server

How to use

Install and start the MCP server, then configure your MCP client to load the new server as a local tool. Once configured, you can perform common Azure DevOps actions from your editor or CLI: retrieve work items, create and update items, search work items, manage boards, trigger pipelines, create and update pull requests, access and edit wiki pages, and list or inspect projects. The server exposes a set of tools you call from your MCP client to interact with Azure DevOps services without leaving your development environment.

How to install

Prerequisites ensure you have Node.js and npm, plus access to an Azure DevOps account and a Cline installation.

Installing via Smithery automatically pulls in the MCP server and prepares it for use.

npx -y @smithery/cli install @cakriwut/ado-mcp-server --client claude

Manual installation steps if you prefer to set things up yourself.

git clone https://github.com/cakriwut/ado-mcp-server.git
cd ado-mcp-server
npm install
npm run build

Configuration

Create and add the MCP server configuration to your client settings to enable Azure DevOps interactions.

{
  "mcpServers": {
    "azure-devops-mcp-server": {
      "command": "node",
      "args": ["C:/absolute/path/to/ado-mcp-server/build/index.js"],
      "env": {
        "AZURE_DEVOPS_ORG": "your-organization",
        "AZURE_DEVOPS_PAT": "your-personal-access-token",
        "AZURE_DEVOPS_PROJECT": "your-project-name"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Important notes for configuration

Use forward slashes in Windows paths and provide the full absolute path to the built entry point.

Restart your editor or IDE after updating the configuration to ensure the new MCP server is loaded.

Verification

After configuring, restart the editor and verify that the Azure DevOps MCP server appears in the list of available MCP servers or capabilities. You can also run the inspector to confirm the server is functioning correctly.

Troubleshooting

If the server isn’t connecting, verify the path to the built entry point, recheck your Azure DevOps credentials, and review editor logs for error messages.

If authentication fails, ensure your PAT is valid and has all required scopes, and confirm your organization and project names are correct.

Development

To modify or extend the server, work in the src directory, run development builds with a watch workflow, and test changes using the inspector tool. Build final changes before production usage.

Testing

The project includes tests for MCP server commands to validate Azure DevOps interactions. Use an environment file with organization, project, and PAT values when running tests.

get_work_item

Retrieve a work item by its ID from Azure DevOps.

list_work_items

Query work items using WIQL to retrieve multiple items.

create_work_item

Create a new work item such as Bug, Task, or User Story.

update_work_item

Update fields on an existing work item.

search_work_items

Search for work items by text across the project.

add_work_item_comment

Add a comment to a specific work item.

get_work_item_comments

Fetch comments for a given work item.

get_boards

List boards available within the project.

list_pipelines

List all pipelines in the project.

trigger_pipeline

Trigger or run a pipeline in the project.

list_pull_requests

List pull requests in the repository.

create_pull_request

Create a new pull request.

update_pull_request

Update an existing pull request.

get_wikis

List all wikis in the project.

list_wiki_pages

List pages within a wiki.

get_wiki_page

Retrieve a wiki page by path.

create_wiki

Create a new wiki.

update_wiki_page

Create or update a wiki page.

create_wiki_page

Create a new wiki page.

search_wiki_page

Search for wiki pages by text.

list_projects

List all projects in the Azure DevOps organization.