Azure DevOps Local MCP Server, Microsoft's official server you run yourself

• Opens work items, your assigned items, comments and change history

  Gets one or many work items by ID, lists the items assigned to you or in an iteration, and shows their comments, revision history and work item type details.

  Try: “Show me my open work items in the Contoso project”

  Read · wit_work_item

• Searches work items by text and filters

  Finds work items across projects by keywords, with filters such as state, type or assigned person.

  Try: “Find bugs mentioning login timeout”

  Read · search_workitem

• Runs saved work item queries or a custom query

  Opens a saved query by ID or path, runs it and returns the results, or runs a custom WIQL query you describe.

  Try: “Run my 'Active bugs' saved query”

  Read · wit_query

• Lists backlog levels and reorders backlog items

  Lists a team's backlog levels and the work items on each, and can move items up or down a backlog or iteration.

  Try: “Show the stories on our team backlog”

  Write · wit_backlog

• Creates, updates and adds child work items

  Creates new work items, updates fields and relations on one or many items, and adds child items under a parent.

  Try: “Create a bug for the checkout crash and assign it to me”

  Write · wit_work_item_write

• Adds or edits comments on a work item

  Adds a new comment to a work item or updates one that already exists.

  Try: “Comment on item 4521 that the fix is in review”

  Write · wit_work_item_comment_write

• Links or unlinks work items, pull requests and builds

  Links two work items, removes links, links a work item to a pull request, or adds a repository, branch, commit or build link.

  Try: “Link work item 4521 to pull request 67”

  Delete · wit_work_item_link_write

• Downloads a work item attachment

  Downloads a file attached to a work item, saving it on your computer or returning its contents.

  Try: “Download the screenshot attached to bug 4521”

  Files · wit_work_item_attachment

• Uploads a file as a new attachment

  Uploads a file to Azure DevOps as an attachment, without linking it to a work item yet.

  Try: “Upload error.log as an attachment”

  Write · wit_work_item_attachment_upload

• Attaches an uploaded file to a work item

  Links an attachment you already uploaded to a specific work item.

  Try: “Attach the uploaded log to bug 4521”

  Write · wit_work_item_attachment_link

• Opens and lists pull requests

  Gets a pull request by ID, lists pull requests in a repository or project, and finds the pull requests that contain given commits.

  Try: “List open pull requests in the web-app repo”

  Read · repo_pull_request

• Lists your active pull requests across the organization

  Shows the pull requests you are involved in that are still active, across every project in the organization.

  Try: “Which of my pull requests are still open?”

  Read · repo_pull_request_org

• Reads review comment threads on a pull request

  Lists the comment threads on a pull request and the comments inside each thread.

  Try: “Show the review comments on pull request 67”

  Read · repo_pull_request_thread

• Creates and updates pull requests, reviewers and votes

  Creates a pull request, updates it (including auto-complete), adds or removes reviewers, and casts your review vote.

  Try: “Open a pull request from feature/login into main”

  Write · repo_pull_request_write

• Writes, replies to and resolves review comments

  Starts a new comment thread on a pull request, replies to a thread, edits a comment, or changes a thread's status such as resolved.

  Try: “Reply to the first review thread on PR 67 and mark it resolved”

  Write · repo_pull_request_thread_write

• Finds and lists repositories

  Gets a repository by name or ID, or lists the repositories in a project.

  Try: “List the repos in the Contoso project”

  Read · repo_repository

• Lists branches, including the ones you pushed

  Gets a branch by name, lists branches in a repository, or lists the branches you have pushed to.

  Try: “Which branches have I pushed to in web-app?”

  Read · repo_branch

• Reads files and folders in a repository

  Reads the text of a file at a branch, tag or commit, and lists the files and folders in a directory.

  Try: “Show me README.md on the main branch”

  Read · repo_file

• Searches commits by text, author or date

  Searches a repository's commits with filters such as text, author and date range.

  Try: “Find commits by Sam in the last week”

  Read · repo_search_commits

• Searches code across repositories

  Finds code across your Azure DevOps repositories by keyword.

  Try: “Search our repos for where the retry policy is defined”

  Read · search_code

• Creates or edits a file and commits it

  Creates or updates a text file on an existing branch and commits the change.

  Try: “Fix the typo in docs/setup.md on my branch and commit it”

  Write · repo_file_write

• Creates a branch

  Creates a new branch in a repository.

  Try: “Create a branch called fix/login-timeout from main”

  Write · repo_create_branch

• Lists builds and shows status and changes

  Lists builds with filters, shows a build's status and issues, and lists the commits and work items included in it.

  Try: “Why did last night's build fail?”

  Read · pipelines_build

• Reads build logs

  Lists the logs for a build and reads the text of a specific log.

  Try: “Show the log for the failing step in build 1234”

  Read · pipelines_build_log

• Opens and lists pipeline runs

  Gets a single pipeline run or lists the runs of a pipeline.

  Try: “List the last five runs of the deploy pipeline”

  Read · pipelines_run

• Lists pipelines and their change history

  Lists pipeline definitions with filters and shows a definition's revision history.

  Try: “Which pipelines exist in the Contoso project?”

  Read · pipelines_definition

• Lists and downloads build artifacts

  Lists the artifacts a build produced and downloads a named artifact.

  Try: “Download the drop artifact from build 1234”

  Files · pipelines_artifact

• Runs, creates, renames pipelines and controls stages

  Queues a new pipeline run, creates a YAML pipeline, renames a pipeline, or cancels, retries or runs a stage on a build in progress.

  Try: “Run the deploy pipeline on main”

  Write · pipelines_write

• Lists test plans, suites and cases

  Lists the test plans in a project, the suites in a plan and the test cases in a suite.

  Try: “List test plans for Contoso”

  Read · testplan

• Shows test results for a build

  Gets the test results produced by a specific build.

  Try: “Which tests failed in build 1234?”

  Read · testplan_show_test_results_from_build_id

• Creates a test plan

  Creates a new test plan in a project.

  Try: “Create a test plan for the 2.0 release”

  Write · testplan_test_plan_write

• Creates test suites and adds test cases

  Creates a test suite inside a test plan and adds existing test cases to a suite.

  Try: “Add the login test cases to the regression suite”

  Write · testplan_test_suite_write

• Creates test cases and edits their steps

  Creates a new test case work item or updates the steps of an existing one.

  Try: “Write a test case for resetting a password”

  Write · testplan_test_case_write

• Lists wikis and reads wiki pages

  Lists wikis in an organization or project, gets a wiki's details, lists its pages and reads a page's content.

  Try: “Get the content of the '/API/Authentication' wiki page”

  Read · wiki

• Searches wiki pages by keyword

  Finds wiki pages that match your keywords.

  Try: “Search the wiki for deployment checklist”

  Read · search_wiki

• Creates or updates a wiki page

  Creates a new wiki page or replaces the content of an existing one.

  Try: “Create a wiki page '/Architecture/Overview' about our system design”

  Write · wiki_upsert_page

• Shows iterations, team settings and capacity

  Lists the iterations in a project or assigned to a team, shows team settings such as the default iteration and area path, and shows team and iteration capacity.

  Try: “List the iterations for Contoso Team”

  Read · work

• Creates iterations and assigns them to teams

  Creates new iterations and assigns iterations to a team.

  Try: “Create Sprint 42 and assign it to Contoso Team”

  Write · work_iteration_write

• Updates a team member's capacity for an iteration

  Changes how much time a team member has available in a given iteration.

  Try: “Set Sam's capacity to 4 hours a day for Sprint 42”

  Write · work_capacity_write

• Lists security alerts for a repository

  Retrieves the Advanced Security alerts, such as vulnerable dependencies or leaked secrets, found in a repository.

  Try: “Show open security alerts for the web-app repo”

  Read · advsec_get_alerts

• Shows details of one security alert

  Gets the full details of a specific Advanced Security alert.

  Try: “Explain security alert 12 in web-app”

  Read · advsec_get_alert_details

• Lists the projects in your organization

  Lists every project in your Azure DevOps organization.

  Try: “List my ADO projects”

  Read · core_list_projects

• Lists the teams in a project

  Lists the teams within a project.

  Try: “List teams for project Contoso”

  Read · core_list_project_teams

• Used by the assistant behind the scenes

  Looks up people's identity IDs

  Finds the internal identity IDs of users or groups from a search, which other tools need to assign or mention people.

  Try: “Look up the identity ID for sam@contoso.com”

  Read · core_get_identity_ids

Watch out for

• There is no read-only mode on this version

  Every write tool loads by default and Microsoft does not plan a read-only switch here. Load only the tool groups you need, or use the hosted server, which has one. github.com

• It can commit code and run pipelines

  It can commit files, create and update pull requests, queue or cancel pipeline runs, edit wiki pages and remove work item links. Ask it to show you each change before it runs. github.com

• Keep tokens out of the config file

  Token sign-in reads from environment variables. Set them outside the config file or in a secrets manager, never in a file you commit. github.com

• It acts as your own account

  The assistant can reach everything your account can in that organization. A token with narrow scopes limits that. github.com

Security advisories

In their words