ado-mcp

Configuration

All configuration is read from the environment.

Variable	Required	Description
ADO_ORG_URL	yes	Organization URL, e.g. https://dev.azure.com/myorg.
ADO_PAT	yes	Azure DevOps Personal Access Token. Sent via Basic auth.
SEVENPACE_ORG	no	7pace account name; builds https://{org}.timehub.7pace.com/api/odata/{version}.
SEVENPACE_API_BASE	no	Full 7pace API base URL; overrides the URL derived from SEVENPACE_ORG.
SEVENPACE_TOKEN	no	7pace bearer token (Settings, Reporting and API). Enables 7pace tools.
ADO_TOOLSETS	no	Comma-separated toolset names to enable, or all (default).
ADO_READONLY	no	Truthy (1, true, yes, on) to expose only read-only tools.
ADO_MCP_HOME	no	Override the app directory (default: <user config dir>/ado-mcp, e.g. ~/.config/ado-mcp). The notes SQLite database lives in data/ within it.
ADO_CACHE_TTL	no	How long GET responses are cached in memory, e.g. 1m. 0 or off disables caching. Default: 30s. Any write clears the cache immediately.
SEVENPACE_REST_BASE	no	Full 7pace write-capable REST API base URL; overrides the URL derived from SEVENPACE_ORG (default https://{org}.timehub.7pace.com/api/rest). Only used by sevenpace_create_worklog and notes_push_sevenpace.

7pace is optional: its tools register only when SEVENPACE_TOKEN is set together with either SEVENPACE_ORG or SEVENPACE_API_BASE.

Use with Claude Desktop / Claude Code

Add to your MCP client configuration (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "ado": {
      "command": "ado",
      "args": ["mcp"],
      "env": {
        "ADO_ORG_URL": "https://dev.azure.com/myorg",
        "ADO_PAT": "your-pat",
        "SEVENPACE_ORG": "myorg",
        "SEVENPACE_TOKEN": "your-7pace-token"
      }
    }
  }
}

For Claude Code: claude mcp add ado --env ADO_ORG_URL=... --env ADO_PAT=... -- ado mcp.

Local development

The repo ships a committed .mcp.json that runs the server straight from source (go run ./cmd/ado mcp), so changes take effect on the next session without a build step. It reads credentials from your environment (no secrets in the repo). Run cp .env.example .env and fill it in, or export ADO_ORG_URL and ADO_PAT (and optionally SEVENPACE_ORG/SEVENPACE_TOKEN) before launching Claude Code in this directory. A local .claude/settings.local.json auto-trusts the server via "enableAllProjectMcpServers": true.

Next: the CLI

With credentials in place, see the CLI reference for ado test (verify the connection) and ado note (the local notes store).

This site is open source. Improve this page.