MCP Directory

How to add Azure DevOps MCP Server to Cursor

Bring Azure DevOps context — work items, repos, pipelines, wikis, test plans — to your AI agents. Paste the config into ~/.cursor/mcp.json and restart Cursor.

Last updated June 14, 2026 · 1.9k★ · stdio · oauth

Cursor config for Azure DevOps MCP Server

npx -y @azure-devops/mcp <organization>
{
  "mcpServers": {
    "azure-devops-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@azure-devops/mcp",
        "${input:ado_org}"
      ]
    }
  }
}

Setup steps

  1. 1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
  2. 2Paste the Azure DevOps MCP Server config below into the "mcpServers" object.
  3. 3Fill in placeholder secrets, then save.
  4. 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
  5. 5Ask Cursor to use one of Azure DevOps MCP Server's tools to confirm it's connected.

Before you start

  • Node.js 20+
  • An Azure DevOps organization and account with appropriate permissions
  • An MCP client (e.g. VS Code + GitHub Copilot, Visual Studio 2022, Claude Code, Cursor)

What Azure DevOps MCP Server can do in Cursor

mcp_ado_core_list_projects

List all projects in the organization.

mcp_ado_core_list_project_teams

List teams within a project.

mcp_ado_core_get_identity_ids

Retrieve Azure DevOps identity IDs by search filter.

mcp_ado_wit_get_work_item

Get a work item by ID.

mcp_ado_wit_get_work_items_batch_by_ids

Retrieve multiple work items by IDs.

mcp_ado_wit_create_work_item

Create a new work item.

mcp_ado_wit_update_work_item

Update fields of a work item.

mcp_ado_wit_add_child_work_items

Create child work items under a parent.

Security

Authentication uses your Microsoft account via interactive browser sign-in (or Azure CLI with --authentication azcli); ensure the credentials match the targeted Azure DevOps organization. The server inherits the permissions of the signed-in identity, so it can read and modify work items, repos, pipelines, and wikis. Use Domains (-d) to restrict the loaded toolset. The download-artifact tool only accepts relative destination paths (absolute paths and path traversal are blocked).

Azure DevOps MCP Server + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Azure DevOps MCP Server config there under the "mcpServers" key and restart the client.

Is Azure DevOps MCP Server safe to use with Cursor?

Authentication uses your Microsoft account via interactive browser sign-in (or Azure CLI with --authentication azcli); ensure the credentials match the targeted Azure DevOps organization. The server inherits the permissions of the signed-in identity, so it can read and modify work items, repos, pipelines, and wikis. Use Domains (-d) to restrict the loaded toolset. The download-artifact tool only accepts relative destination paths (absolute paths and path traversal are blocked).

Is this an official Microsoft project?

Yes. It is published by Microsoft (microsoft/azure-devops-mcp) and wraps Microsoft's own Azure DevOps service.

How do I authenticate?

The first time a tool runs, a browser opens to sign in with your Microsoft account; use credentials that match the targeted Azure DevOps organization. You can also pass --authentication azcli to use Azure CLI credentials.

How do I limit which tools are loaded?

By default all domains load. Add '-d' followed by domain names (core, work, work-items, search, test-plans, repositories, wiki, pipelines, advanced-security) to the server args to load only what you need. Always keep 'core' enabled for project-level info.

View repo Full Azure DevOps MCP Server page