AzDo 1.2.1

There is a newer version of this package available.
See the version list below for details.

dotnet tool install --global AzDo --version 1.2.1

This package contains a .NET tool you can call from the shell/command line.

dotnet new tool-manifest
                    

                            if you are setting up this repo

dotnet tool install --local AzDo --version 1.2.1

This package contains a .NET tool you can call from the shell/command line.

#tool dotnet:?package=AzDo&version=1.2.1

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

nuke :add-package AzDo --version 1.2.1

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

azdo — Command Reference

Version: 1.2.0 | Package: AzDo | MCP Tools: 68

All commands support --org and --project overrides (optional — auto-detected from git remote, or .azdo file if not in a git repo).

All read commands support --table to render output as an ASCII table instead of JSON (overrides --compact). In MCP mode, pass "table": true.

📋 CLI Commands

Context

Command	Description
`azdo context`	Detect Azure DevOps org/project/repo from the current git remote (or `.azdo` file). Shows whether the detected org is registered. Use to verify what `azdo` sees before running other commands.

.azdo file: If not in a git repo, azdo searches parent directories for a .azdo JSON file:
{ "org": "myorg", "project": "myproject" }
org is required; project is optional.

When inside a git repository, the .azdo file is ignored — git remote always wins.

Configuration

Command	Description
`azdo config list`	List all configured organizations with masked PATs. Shows org name and URL. Use to verify which orgs are registered before working across multiple tenants.
`azdo config add --org X --pat <token>`	Register an organization with a Personal Access Token (PAT). The PAT is stored in `~/.config/azdo/config.json` with permissions 600 and never leaves your machine. Required PAT scopes: `vso.work`, `vso.code`, `vso.build`, `vso.graph`, `vso.memberentitlementmanagement`.
`azdo config remove --org X`	Remove an organization and its stored PAT from local config. Safe to run — only deletes the local credential entry.
`azdo config path`	Print the full path to the config file on disk. Useful for scripting or manual inspection.

Work Items

Command	Description
`azdo wi query --wiql "SELECT ..." [--top 10] [--compact] [--table]`	Run a WIQL (Work Item Query Language) query against Azure DevOps. Returns matching work items with id, type, state, title, assigned-to, and changed-date. Standard ADO WIQL syntax. `--table` renders a compact terminal-friendly table.
`azdo wi get --ids 1,2,3 [--fields System.Title,System.State] [--compact] [--table]`	Fetch one or more work items by comma-separated numeric IDs. Use `--fields` to limit returned fields (e.g. `System.Title,System.AssignedTo`).
`azdo wi create --type Task --title "..." [--description "..."] [--assigned-to me@eng.it] [--parent 1234] [--iteration "MyProject\\Sprint 1"]`	Create a new work item (Task, Bug, User Story, Feature, Epic). Optionally link to a parent work item, assign to a team member (by email), and place in an iteration (full path with escaped `\\`).
`azdo wi update --id 1234 [--state Active] [--title "..."] [--assigned-to me@eng.it]`	Update an existing work item's state, title, or assignee. Only the fields you provide are changed — partial update.
`azdo wi comment --id 1234 --text "..."`	Add a text comment to a work item. Comments appear in the Discussion section of the work item in the Azure DevOps UI.
`azdo wi hierarchy --id 1234 [--table]`	Get a work item with its full child tree (recursive parent → children → grandchildren). With `--table`, children are indented visually.
`azdo wi link --source 1234 --target 5678 --type child`	Link two work items. Link types: `child` (source becomes parent of target), `parent` (source becomes child of target), `related`, `duplicate`.
`azdo wi search --query "keyword" [--type Bug] [--top 10] [--table]`	Full-text search across all work items. Matches title, description, and other text fields. Requires Azure DevOps search indexing to be enabled in the organization.

Projects

Command	Description
`azdo project list [--top 20] [--skip 10] [--compact] [--table]`	List all projects in the organization with id, name, state, visibility, and last-update timestamp. Use `--top`/`--skip` for pagination.
`azdo project get --id <name-or-id> [--compact] [--table]`	Get detailed information about a single project by its UUID or name. Returns full metadata including URL, description, visibility, and revision.
`azdo project clone-all [--output <dir>] [--ssh] [--dry-run] [--parallel 4]`	Clone (or pull if already cloned) every repository from every project in the organization. Outputs to `org/project/repo` folder structure. `--parallel 4` speeds up large orgs. `--dry-run` previews without cloning.

Boards — Iterations, Teams, Areas

Command	Description
`azdo board iterations [--team X] [--compact] [--table]`	List all iterations (sprints) for a project, optionally filtered by team. Shows name, path, start/finish dates, and timeframe.
`azdo board iteration current [--team X] [--compact] [--table]`	Get the currently active sprint for a team. Returns the single iteration that contains today's date. Useful for CI/CD scripts.
`azdo board teams [--compact] [--table]`	List all teams in the project with id, name, and description. Team names can be used as `--team` in other board commands.
`azdo board members --team-id X [--compact] [--table]`	List all members of a specific team with display name, unique name, and identity id. `--team-id` accepts both UUID and team name.
`azdo board areas [--depth 5] [--compact] [--table]`	List area paths as a flattened tree. With `--table`, depth is shown via indentation. Use `--depth` to control nesting level (default 5).
`azdo board backlog [--team X] [--compact] [--table]`	Get the product backlog for a team. Shows backlog levels (Epics, Features, Stories) with name, type, and rank. This retrieves the backlog configuration, not individual work items.
`azdo board sprint --iteration X [--team X] [--table]`	Get the sprint backlog — work items assigned to a specific iteration. `--iteration` is required (name or full path like `"MyProject\\Sprint 1"`).
`azdo board iteration create --name "Sprint 42" [--start 2026-01-01] [--finish 2026-01-14]`	Create a new sprint/iteration in the project. Dates use ISO 8601 format.
`azdo board area create --name "NewArea" [--parent "ParentArea"]`	Create a new area path, optionally nested under a parent area. Parent uses the short name, not the full path.
`azdo board team create --name "MyTeam" [--description "..."]`	Create a new team in the project. After creating, use `set-area` to assign it an area path.
`azdo board team set-area --team-id X --area-path "Project\\Area"`	Assign an area path to a team. Area path must be the full path including project root.
`azdo board team add-member --team-id X --member-id <guid>`	Add a user to a team. `--member-id` must be the Azure DevOps identity GUID — use `azdo identity search` to find it.
`azdo board team remove-member --team-id X --member-id <guid>`	Remove a user from a team by their identity GUID. Does not remove the user from the org — only from the team.

Identity, Users & Groups

Command	Description
`azdo identity search --query "email@example.com" [--top 20] [--compact] [--table]`	Search Azure DevOps identities by email or display name via the Graph API. Returns descriptor (e.g. `aad.…`), display name, email, principal name, origin, and subject kind. Use to find GUIDs needed for team/group operations. Requires `vso.graph` PAT scope.
`azdo identity list-users [--top 100] [--skip 0] [--compact] [--table]`	List all users in the organization with entitlements (license type, status). Uses the Member Entitlement Management API. Requires `vso.memberentitlementmanagement` PAT scope.
`azdo identity add-user --email user@example.com [--license express]`	Invite a new user to the Azure DevOps organization. Default license is `express` (free Basic). Options: `express`, `stakeholder`, `basic`, `advanced`, `basicAndTestPlans`. User receives an invitation email.
`azdo identity remove-user --id <guid>`	Remove a user from the organization by their entitlement ID (GUID from `list-users`). Permanent — the user loses access to all projects.
`azdo identity list-groups [--compact] [--table]`	List all groups in the organization. Shows display name, description, origin, scope type, and descriptor (e.g. `vssgp.…`). Use descriptors in group member operations.
`azdo identity group-members --descriptor vssgp.… [--compact] [--table]`	List all members of a group by its Graph descriptor. Members can be users or nested groups. Member names are resolved automatically.
`azdo identity group-create --name "MyGroup" [--description "..."]`	Create a new group. If `--project` is provided (or auto-detected), creates a project-scoped group; otherwise org-wide.
`azdo identity group-member-add --group vssgp.… --member aad.…`	Add a user or group to a group. Both identified by their Graph descriptors.
`azdo identity group-member-remove --group vssgp.… --member aad.…`	Remove a member from a group by descriptor. Does not delete the member — only removes membership.

Note: Identity and group tools use the Azure DevOps Graph API (vssps.dev.azure.com). User entitlement tools use the Member Entitlement Management API (vsaex.dev.azure.com). These require vso.graph and vso.memberentitlementmanagement PAT scopes respectively.

Repositories & Git

Command	Description
`azdo repo list [--top 20] [--skip 10] [--compact] [--table]`	List all repositories in the project with id, name, and default branch. Supports pagination.
`azdo repo create --name "MyNewRepo"`	Create a new empty Git repository in the project. Clone the returned SSH or HTTPS URL to start working.
`azdo repo branches --repo X [--search feature] [--top 20] [--compact] [--table]`	List branches in a repository. `--search` filters by name (contains). Returns branch name, abbreviated object ID, and creator.
`azdo repo branch create --repo X --name feature/foo --from main`	Create a new branch from a source ref (branch name or commit SHA). `--from` accepts both `main` and `refs/heads/main`.
`azdo repo branch delete --repo X --name feature/foo`	Delete a branch from the remote repository. Your local clone is not affected.
`azdo repo commits --repo X [--branch main] [--author ...] [--since 2026-01-01] [--until 2026-06-01] [--top 50] [--skip 0] [--compact] [--table]`	List commits with full filtering: branch, author email, date range (ISO 8601), and pagination. Each commit shows abbreviated SHA, author, email, date, and message.
`azdo repo diff --repo X --base main --target feature/foo [--table]`	Get the diff (changed files) between two commits or branches. With `--table`, shows a compact CHANGE \| PATH table. Without it, returns the full REST API response.
`azdo repo file --repo X --path src/Program.cs [--ref main] [--table]`	Fetch a single file's content from a repository at a specific branch or commit. Returns path, commit ID, encoding, and content. `--ref` defaults to the default branch.
`azdo repo file push --repo X --path src/foo.cs --content "..." --branch main --message "Add foo.cs"`	Create or update a file via a direct commit to a branch. No local clone needed. Ideal for CI/CD pipelines that need to commit generated files.
`azdo repo file delete --repo X --path src/foo.cs --branch main --message "Remove foo.cs"`	Delete a file via a direct commit. The file is removed immediately; commit history is preserved.
`azdo repo tags --repo X [--compact] [--table]`	List annotated and lightweight tags in a repository. Shows tag name (without `refs/tags/` prefix), abbreviated object ID, and creator.
`azdo repo tag create --repo X --name v1.0 --message "Release v1.0" --object-id <sha>`	Create an annotated tag pointing to a specific commit. `--object-id` is the full commit SHA.
`azdo repo clone-all [--output <dir>] [--ssh] [--dry-run] [--parallel 4]`	Clone (or pull if already cloned) all repositories in the project. Scoped to the current project. Use `--ssh` for SSH URLs.

Pull Requests

Command	Description
`azdo pr list [--repo X] [--status active] [--creator me@eng.it] [--top 20] [--skip 0] [--compact] [--table]`	List pull requests with optional filters. Status: `active`, `abandoned`, `completed`, `all`. Shows id, title, status, draft flag, creator, date, and source→target branches. Without `--repo`, lists across the whole project.
`azdo pr create --title "..." [--repo X] [--source feature/foo] [--target main] [--description "..."] [--draft] [--work-item 1234] [--reviewer <guid>]`	Create a new pull request. Defaults: source = current git branch, target = `main`, repo = detected from git remote. Supports draft mode, work item linking, and reviewer assignment (reviewers must be identity GUIDs — use `azdo identity search`).
`azdo pr vote --pr 1234 [--repo X] --voter-id <guid> --vote 10`	Vote on a pull request. Vote values: `10`=approve, `5`=approve with suggestions, `0`=reset, `-5`=waiting, `-10`=reject. Find your `--voter-id` GUID in your ADO profile URL.
`azdo pr abandon --pr 1234 [--repo X]`	Abandon a pull request. Equivalent to closing without merging.
`azdo pr complete --pr 1234 [--repo X] [--delete-source]`	Complete (merge) a pull request. `--delete-source` removes the source branch after merging. PR must be mergeable (no conflicts, policies satisfied).
`azdo pr detail --pr 1234 [--repo X] [--table]`	Get full PR details: title, status, creator, branches, merge status, reviewer votes (decoded: `10`=approved, `-10`=rejected), and labels. With `--table`, reviewers are shown as a nested table.
`azdo pr threads --pr 1234 [--repo X] [--compact] [--table]`	List all review threads on a PR: inline comments, file paths, line numbers, authors, and thread status (active/resolved). Shows the first comment of each thread.
`azdo pr comment --pr 1234 --text "..." [--repo X] [--file src/Foo.cs --line 42]`	Add a comment to a pull request. Without `--file`/`--line`, creates a top-level thread. With file/line, creates an inline comment on the code diff.

Builds, Pipelines & Releases

Command	Description
`azdo build list [--top 20] [--definition 5] [--compact] [--table]`	List recent builds. Filter by pipeline definition ID. Shows build number, pipeline name, status, result, branch, queue time, and finish time. `--table` renders perfect CI dashboard tables.
`azdo build status --id 1234 [--compact] [--table]`	Get detailed build status with all timeline records (tasks, phases). With `--table`, shows a vertical info block + TIMELINE sub-table with each task's state, result, and timing.
`azdo build trigger --definition 5 [--branch refs/heads/main]`	Trigger a new pipeline run. `--branch` defaults to `refs/heads/main`.
`azdo build logs --id 1234 [--compact] [--table]`	List task-level log URLs for a build. Each log has an id, type, and URL to the raw log content on Azure DevOps blob storage.
`azdo pipeline list [--top 20] [--compact] [--table]`	List all YAML and classic pipelines with id, name, folder, and revision. The id is the `--definition` value for `build list` and `build trigger`.
`azdo release definitions [--search X] [--top 20] [--compact] [--table]`	List release definitions with optional name search. Shows id, name, path, creator, and creation date.
`azdo release list [--definition 5] [--status active] [--top 20] [--compact] [--table]`	List releases, optionally filtered by definition and status (`active`/`completed`). Shows environments with their deployment statuses inline.
`azdo release trigger --definition 5 [--description "..."]`	Trigger a new release from a release definition. The description appears in the release history.

Wiki

Command	Description
`azdo wiki list [--compact] [--table]`	List all wikis in the project. Shows id, name, type (project/code), and version. The id or name is used in other wiki commands.
`azdo wiki page --wiki-id X --path "/Architecture/Overview" [--compact] [--table]`	Fetch a wiki page by path. Returns page content (Markdown), path, title, and URL. Path must match exactly.
`azdo wiki upsert --wiki-id X --path "/Guide" --content "# Hello"`	Create or update a wiki page. Content must be valid Markdown. Path must start with `/`. Creates parent pages automatically.

Search

Command	Description
`azdo search code --query "IDisposable" [--repo X] [--top 20] [--table]`	Full-text search across all code files (or scoped to a repo). Results show file name, path, repository, and match count. Requires Azure DevOps code search indexing to be enabled.
`azdo search wi --query "authentication" [--type Bug] [--top 20] [--table]`	Full-text search across work items. Optionally filter by type. Matches across title, description, and text fields. Requires work item search indexing.

MCP Server

Command	Description
`azdo mcp serve [--transport stdio\|http] [--port 9287]`	Start the MCP server. `stdio` for Claude Desktop/Copilot/Cursor (default). `http` transport with SSE for browser-based clients on the specified port. All 68 tools become available to your AI agent.
`azdo mcp list-tools`	List all 68 MCP tools as a JSON array with name, description, and input schema. Output is the raw `tools/list` MCP response.

🔌 MCP Tools (68 total)

Use these in Claude Desktop, Copilot, Cursor, or any MCP-compatible agent.

Context & Session

Tool	Required Args	Optional Args	Description
`azdo_context`	(none)	—	Detect org/project/repo from git remote. Returns detected org URL, project, repo, registration status, and session overrides.
`azdo_context_set`	(none)	`org`, `project`	Set default org/project overrides for the current session. Used when a tool call omits org/project.

Work Items

Tool	Required Args	Optional Args	Description
`azdo_wi_query`	`wiql`	`top`, `compact`, `table`, `org`, `project`	Run a WIQL query against work items. Returns matching items with id, type, state, title, assigned-to, changed-date.
`azdo_wi_get`	`ids`	`fields`, `compact`, `table`, `org`, `project`	Get one or more work items by comma-separated IDs. `fields` limits returned system fields (e.g. `System.Title,System.State`).
`azdo_wi_create`	`type`, `title`	`description`, `assignedTo`, `parent`, `iteration`, `org`, `project`	Create a work item (Task, Bug, User Story, Feature, Epic). `parent` links to a parent work item. `iteration` uses the full path.
`azdo_wi_update`	`id`	`state`, `title`, `assignedTo`, `parent`, `iteration`, `org`, `project`	Update a work item. Only provided fields are changed.
`azdo_wi_comment`	`id`, `text`	`org`, `project`	Add a comment to a work item's Discussion section.
`azdo_wi_hierarchy`	`id`	`table`, `org`, `project`	Get work item with full child tree (recursive). With `table: true`, shows an indented tree.
`azdo_wi_link`	`sourceId`, `targetId`, `linkType`	`org`, `project`	Link two work items. `linkType`: `child`, `parent`, `related`, `duplicate`.
`azdo_wi_search`	`query`	`type`, `top`, `table`, `org`, `project`	Full-text search on work items. Filter by type. Requires search indexing enabled.

Projects

Tool	Required Args	Optional Args	Description
`azdo_project_list`	(none)	`top`, `skip`, `compact`, `table`, `org`	List projects in the organization.
`azdo_project_get`	`id`	`compact`, `table`, `org`	Get project details by ID or name.
`azdo_project_clone_all`	(none)	`org`, `output`, `ssh`, `dryRun`, `parallel`	Clone (or pull) all repos from all projects to `org/project/repo` structure.

Boards — Iterations

Tool	Required Args	Optional Args	Description
`azdo_iterations_list`	(none)	`team`, `compact`, `table`, `org`, `project`	List iterations/sprints for a project.
`azdo_iteration_current`	(none)	`team`, `compact`, `table`, `org`, `project`	Get the currently active sprint for a team.
`azdo_iteration_create`	`name`	`startDate`, `finishDate`, `org`, `project`	Create a new sprint/iteration. Dates in ISO 8601.

Boards — Teams

Tool	Required Args	Optional Args	Description
`azdo_teams_list`	(none)	`compact`, `table`, `org`, `project`	List teams in a project.
`azdo_members_list`	`teamId`	`compact`, `table`, `org`, `project`	List members of a team by ID or name.
`azdo_team_create`	`name`	`description`, `org`, `project`	Create a new team.
`azdo_team_area_set`	`teamId`, `areaPath`	`org`, `project`	Assign an area path to a team. Area path must include project root.
`azdo_team_member_add`	`teamId`, `memberId`	`org`, `project`	Add a user to a team. `memberId` must be an identity GUID.
`azdo_team_member_remove`	`teamId`, `memberId`	`org`, `project`	Remove a user from a team by identity GUID.

Identity, Users & Groups

Tool	Required Args	Optional Args	Description
`azdo_identity_search`	(none)	`query`, `top`, `compact`, `table`, `org`	Search identities by email or display name (Graph API). Returns descriptor, display name, email, principal name, origin, subject kind. Requires `vso.graph` scope.
`azdo_group_list`	(none)	`compact`, `table`, `org`, `project`	List groups in the organization (Graph API). Returns display name, description, origin, scope, descriptor.
`azdo_group_members`	`groupDescriptor`	`compact`, `table`, `org`	List members of a group by descriptor. Members can be users or nested groups.
`azdo_group_create`	`name`	`description`, `org`, `project`	Create a group. Project-scoped if project is provided, otherwise org-wide.
`azdo_group_member_add`	`groupDescriptor`, `memberDescriptor`	`org`	Add a user or group to a group. Both by descriptor.
`azdo_group_member_remove`	`groupDescriptor`, `memberDescriptor`	`org`	Remove a member from a group by descriptor.
`azdo_user_list`	(none)	`top`, `skip`, `compact`, `table`, `org`	List users with entitlements (MEM API). Shows license and status. Requires `vso.memberentitlementmanagement` scope.
`azdo_user_add`	`email`	`license`, `org`	Invite a user to the organization. License: `express` (default), `stakeholder`, `basic`, `advanced`, `basicAndTestPlans`.
`azdo_user_remove`	`userId`	`org`	Remove a user from the organization by entitlement ID (GUID from `user_list`).

Graph descriptors: Group and user descriptors are opaque identifiers like vssgp.… (group) or aad.… (AAD user). Use azdo_identity_search to find user descriptors and azdo_group_list to find group descriptors. azdo_group_members automatically resolves member names via batch subject lookup.

Boards — Areas & Backlogs

Tool	Required Args	Optional Args	Description
`azdo_areas_list`	(none)	`depth`, `compact`, `table`, `org`, `project`	List area paths as a flattened tree. `depth` controls max nesting level.
`azdo_area_create`	`name`	`parentPath`, `org`, `project`	Create a new area path, optionally nested under a parent.
`azdo_backlog_product`	(none)	`team`, `compact`, `table`, `org`, `project`	Get product backlog configuration (levels: Epics, Features, Stories).
`azdo_backlog_sprint`	`iteration`	`team`, `table`, `org`, `project`	Get sprint backlog — work items in a specific iteration. Returns item IDs and URLs.

Repositories — Read

Tool	Required Args	Optional Args	Description
`azdo_repo_list`	(none)	`top`, `skip`, `compact`, `table`, `org`, `project`	List repositories in the project.
`azdo_git_branches`	`repo`	`search`, `top`, `compact`, `table`, `org`, `project`	List branches. `search` filters by name (contains).
`azdo_git_commits`	`repo`	`branch`, `author`, `from`, `to`, `top`, `skip`, `compact`, `table`, `org`, `project`	List commits with full filtering by branch, author, date range, and pagination.
`azdo_git_diff`	`repo`, `base`, `target`	`table`, `org`, `project`	Get diff between two commits/branches. With `table:true`, shows CHANGE \| PATH.
`azdo_git_file`	`repo`, `path`	`ref`, `table`, `org`, `project`	Get file content. `ref` defaults to the default branch.
`azdo_repo_tags_list`	`repo`	`compact`, `table`, `org`, `project`	List annotated and lightweight tags.

Repositories — Write

Tool	Required Args	Optional Args	Description
`azdo_repo_create`	`name`	`org`, `project`	Create a new empty repository.
`azdo_repo_branch_create`	`repo`, `branchName`, `sourceRef`	`org`, `project`	Create a branch from a source ref (branch name or commit SHA).
`azdo_repo_branch_delete`	`repo`, `branchName`	`org`, `project`	Delete a branch from the remote repository.
`azdo_repo_tag_create`	`repo`, `tagName`, `message`, `objectId`	`org`, `project`	Create an annotated tag pointing to a commit SHA.
`azdo_repo_file_push`	`repo`, `path`, `content`, `branch`, `commitMessage`	`org`, `project`	Create or update a file via direct commit. No local clone needed.
`azdo_repo_file_delete`	`repo`, `path`, `branch`, `commitMessage`	`org`, `project`	Delete a file via direct commit.
`azdo_repo_clone_all`	(none)	`org`, `project`, `output`, `ssh`, `dryRun`, `parallel`	Clone all repositories in the project.

Pull Requests

Tool	Required Args	Optional Args	Description
`azdo_pr_list`	(none)	`repo`, `status`, `creator`, `top`, `skip`, `compact`, `table`, `org`, `project`	List pull requests with optional filters. Status: `active`, `abandoned`, `completed`, `all`.
`azdo_pr_create`	`title`	`repo`, `source`, `target`, `description`, `draft`, `workItems`, `reviewers`, `org`, `project`	Create a pull request. Defaults: source = current branch, target = `main`, repo = detected. Reviewers must be identity GUIDs.
`azdo_pr_vote`	`prId`, `repo`, `voterId`, `vote`	`org`, `project`	Vote on a PR: `10`=approve, `5`=approve+suggestions, `0`=reset, `-5`=waiting, `-10`=reject.
`azdo_pr_update`	`prId`, `repo`	`status`, `title`, `autoComplete`, `deleteSourceBranch`, `org`, `project`	Update PR status (`abandoned`/`completed`), title, or enable auto-complete.
`azdo_pr_detail`	`prId`, `repo`	`table`, `org`, `project`	Get PR details with reviewers, votes, labels, and merge status. Votes are decoded in table mode.
`azdo_pr_threads`	`prId`, `repo`	`compact`, `table`, `org`, `project`	List review threads with comments, file paths, line numbers, and status.
`azdo_pr_comment`	`prId`, `repo`, `content`	`threadId`, `file`, `line`, `org`, `project`	Add a comment. With `file`/`line`: inline diff comment. Without: top-level thread.
`azdo_pr_resolve`	`prId`, `repo`, `threadId`	`org`, `project`	Resolve a review thread (mark as closed).

Builds & Pipelines

Tool	Required Args	Optional Args	Description
`azdo_build_list`	(none)	`top`, `definition`, `compact`, `table`, `org`, `project`	List recent builds. Filter by pipeline definition ID.
`azdo_build_status`	`id`	`compact`, `table`, `org`, `project`	Get build status and timeline records (tasks, phases, timing).
`azdo_build_trigger`	`definition`	`branch`, `org`, `project`	Trigger a pipeline run. `branch` defaults to `refs/heads/main`.
`azdo_pipelines_list`	(none)	`top`, `compact`, `table`, `org`, `project`	List YAML and classic pipelines.
`azdo_build_logs`	`buildId`	`compact`, `table`, `org`, `project`	Get task-level log URLs for a build.

Release Management

Tool	Required Args	Optional Args	Description
`azdo_release_definitions`	(none)	`search`, `top`, `compact`, `table`, `org`, `project`	List release definitions with optional name search.
`azdo_release_list`	(none)	`definitionId`, `status`, `top`, `compact`, `table`, `org`, `project`	List releases. Filter by definition and status. Shows environments inline.
`azdo_release_trigger`	`definitionId`	`description`, `org`, `project`	Trigger a release from a release definition.

Wiki

Tool	Required Args	Optional Args	Description
`azdo_wiki_list`	(none)	`compact`, `table`, `org`, `project`	List wikis in the project.
`azdo_wiki_page_get`	`wikiId`, `path`	`compact`, `table`, `org`, `project`	Get a wiki page by path. Returns Markdown content.
`azdo_wiki_page_upsert`	`wikiId`, `path`, `content`	`org`, `project`	Create or update a wiki page. Content must be Markdown.

Search

Tool	Required Args	Optional Args	Description
`azdo_code_search`	`query`	`repo`, `top`, `table`, `org`, `project`	Full-text code search. Results: file name, path, repository, match count.
`azdo_wi_search`	`query`	`type`, `top`, `table`, `org`, `project`	Full-text work item search. Filter by type.

🗳️ Vote Values Reference

Vote	Meaning
`10`	Approved
`5`	Approved with suggestions
`0`	Reset vote
`-5`	Waiting for author
`-10`	Rejected

🔗 Work Item Link Types

Link Type	Description
`child`	Hierarchy-Forward (parent → child)
`parent`	Hierarchy-Reverse (child → parent)
`related`	Related work item
`duplicate`	Duplicate-Forward

📝 Notes

compact: Set to false to get the full raw Azure DevOps API response. Default is true (simplified output optimized for LLM consumption).
table: Set to true to render output as a human-readable ASCII table. Default is false. When table is true, compact is ignored — table format always takes precedence. Available on all read/get/list tools (both CLI and MCP). Useful for quick visual inspection in the terminal.
org / project: Auto-detected from the current git remote, or from a .azdo file if not in a git repo. Pass --org / --project explicitly to override. Use azdo_context_set to set session-level overrides in MCP mode.
.azdo file: Place a .azdo JSON file ({"org":"myorg","project":"myproject"}) in any parent directory of a non-git folder to auto-detect org/project. Ignored when inside a git repository.
voterId: Your Azure DevOps identity GUID (required for voting). Find it in your ADO profile URL: https://dev.azure.com/{org}/_usersSettings/identities.
Reviewer IDs in azdo_pr_create: Must be Azure DevOps identity GUIDs, not email addresses. Use azdo_identity_search to resolve emails to GUIDs.
Code Search (azdo_code_search): Requires the Azure DevOps search indexing to be enabled in the organization. Returns a clear error if disabled.
Wiki tools: Require a project-level wiki. wikiId can be either the wiki UUID or the wiki name.
azdo_wi_hierarchy: Returns the work item with its direct children. Use recursively to walk the full tree.
Identity & Group tools: Require PAT with vso.graph scope (for Graph API) and vso.memberentitlementmanagement scope (for user entitlements). Without these scopes, 401/403 errors are returned.
azdo_user_add license types: express (default, free Basic), stakeholder (free), basic (paid Basic), advanced (paid Basic+TestPlans), basicAndTestPlans (paid).

Product	Compatible and additional computed target framework versions.
.NET	net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed.

Product

.NET

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version	Downloads	Last Updated
1.3.2	104	9/29/2026
1.3.1	125	9/9/2026
1.3.0	115	9/8/2026
1.2.1	135	8/5/2026
1.2.0	120	8/5/2026
1.1.2	128	8/5/2026
1.1.1	128	7/27/2026
1.1.0	123	7/27/2026
1.0.6	131	7/22/2026
1.0.5	120	7/22/2026
1.0.4	121	7/21/2026
1.0.3	114	7/21/2026
1.0.2	136	6/24/2026
1.0.1	137	6/22/2026
1.0.0	131	6/22/2026