ado is a small command tree (built on urfave/cli) with three areas: run the MCP server, check connectivity, and manage a local notes store. A bare ado with no subcommand is equivalent to ado mcp.
ado mcpRun the MCP server over stdio. This is what MCP clients (Claude Desktop/Code, Cursor) invoke — see Configuration for client setup.
ado mcp
ado testVerify connectivity and credentials against Azure DevOps: calls the profile endpoint and prints the authenticated user. Useful for confirming ADO_ORG_URL/ADO_PAT are correct before wiring up an MCP client.
$ ado test
OK connected to https://dev.azure.com/myorg
authenticated as Ada Lovelace <ada@example.com>
read-only=false
ado noteManage the local SQLite notes store backing the notes toolset. These commands do not require Azure DevOps credentials — only ADO_MCP_HOME (optional; see Configuration) applies.
ado note addado note add "<summary>" [flags]
Add a note; <summary> is positional and required. The note’s date defaults to today.
| Flag | Description |
|---|---|
--date |
Note date, YYYY-MM-DD (default: today). |
--start |
Session start, RFC3339 (e.g. 2026-06-29T09:00:00Z). |
--stop |
Session stop, RFC3339. |
--body |
Full note body (Markdown). |
--project, -p |
Project. |
--env |
Environment. |
--service |
Service. |
--version |
Version. |
--repo |
Repository. |
--branch |
Branch. |
--users |
Comma-separated identities. |
ado note listado note list [flags]
List notes, newest first.
| Flag | Description |
|---|---|
--date |
Exact note date, YYYY-MM-DD. |
--from / --to |
Inclusive date range, YYYY-MM-DD. |
--project, -p / --env / --service / --version / --repo / --branch |
Filter by that dimension. |
--user |
Filter by user. |
--search |
Free-text search over summary and body. |
--limit |
Maximum rows to return (default 200). |
ado note updateado note update <id> [flags]
Update one or more fields of an existing note by ID; at least one field flag is required.
| Flag | Description |
|---|---|
--summary, -s |
Short summary. |
--date / --start / --stop / --body / --project / --env / --service / --version / --repo / --branch / --users |
Same as note add. |
ado note deleteado note delete <id> # alias: rm
Delete a note by ID. Deleting a note that doesn’t exist reports an error rather than silently succeeding.
The MCP server itself is organized into Toolsets, each exposing a set of Tools.