Azure DevOps MCP Server for Cline

How to use

You interact with Azure DevOps through your MCP client by invoking the available actions. Use the Work Items tools to query, create, or update items; Boards to inspect project boards; Pipelines to list or trigger pipelines; Pull Requests to manage PRs; Wiki to read or write pages; and Projects to enumerate organization projects. Each action runs against your Azure DevOps project and returns structured results you can feed into your workflows. Start by enabling the Azure DevOps MCP Server in your client’s MCP explorer, then choose the action you want to perform and provide the required inputs (such as item IDs, project names, or pipeline identifiers). When you need to read or modify data, supply the necessary identifiers and payloads, and let the MCP server handle the Azure DevOps API calls on your behalf.

How to install

Prerequisites: Node.js v20 LTS or higher, npm (comes with Node.js), a Cline installation, and an Azure DevOps account with access tokens.

Install Azure DevOps MCP Server for Claude Desktop automatically via Smithery.

npx -y @smithery/cli install @stefanskiasan/azure-devops-mcp-server --client claude

Manual Installation steps to run locally.

git clone https://github.com/stefanskiasan/azure-devops-mcp-server.git
cd azure-devops-mcp-server

npm install

npm run build

Note: The build output (build/ directory) is not included in version control. You must run the build command after cloning the repository.

Configuration

Get an Azure DevOps Personal Access Token (PAT) with the required scopes.

Configure Cline MCP Settings by adding the server configuration to your MCP settings file.

{
  "mcpServers": {
    "azure-devops": {
      "command": "node",
      "args": ["/absolute/path/to/azure-devops-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": []
    }
  }
}

Replace values with your actual paths and credentials.

Verification

Restart Cline (or the Claude desktop app) after adding the configuration. The Azure DevOps MCP server should now be listed in Cline's capabilities. You can verify the installation using the MCP Inspector.

npm run inspector

Troubleshooting

If the server isn’t connecting, verify that the path in your MCP settings is correct, confirm your Azure DevOps credentials, and check the Cline logs for any error messages.

If authentication errors occur, ensure your PAT hasn’t expired, that it has all necessary scopes, and that you’ve specified the correct organization and project names.

For other issues, run the inspector tool to verify the server is working correctly and review the server logs for error messages.

Development

To modify or extend the server, make changes in the src directory, run npm run watch for development, build with npm run build when ready, and test using the inspector with npm run inspector.

get_work_item

Retrieve a work item by ID from the specified Azure DevOps project.

list_work_items

Query and list work items using WIQL (work item query language).

create_work_item

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

update_work_item

Update properties of an existing work item.

get_boards

Fetch available boards within the Azure DevOps project.

list_pipelines

List all pipelines in the project.

trigger_pipeline

Trigger a pipeline execution.

list_pull_requests

List pull requests for a repository.

create_pull_request

Create a new pull request.

update_pull_request

Update an existing pull request.

get_pull_request

Get details of a pull request.

get_wikis

List all wikis in the project.

get_wiki_page

Read a specific wiki page.

create_wiki

Create a new wiki entry.

update_wiki_page

Create or update a wiki page.

list_projects

List all projects in the Azure DevOps organization.