Azure DevOps Wiki

You can use this MCP server to give AI agents access to Azure DevOps Wiki data, enabling search, read/update of pages, and navigation of wiki structures with secure authentication options. It makes it easy to query wikis from your AI workflows and keep content in sync with your Azure DevOps projects.

How to use

Authenticate using either an Azure CLI session or a Personal Access Token (PAT). Once the MCP server is running, your MCP client can perform the following actions: search wiki content, read and update pages, retrieve page trees to understand hierarchy, and list wikis within a project. Provide the organization, project, and wiki identifier as needed for each operation, and include a page path when targeting a specific page.

How to install

Prerequisites you need before installation: Node.js 18 or higher, and the Azure CLI if you plan to authenticate with Azure (not required if you use PAT). Ensure you have appropriate Azure DevOps permissions for the target organization.

{
  "mcpServers": {
    "azure_devops_wiki": {
      "command": "npx",
      "args": ["-y", "azure-devops-wiki-mcp"],
      "env": {
        "AZURE_DEVOPS_URL": "https://dev.azure.com/your-organization",
        "AZURE_DEVOPS_PROJECT": "your-project",
        "AZURE_DEVOPS_PAT": "your-pat-token",
        "AZURE_DEVOPS_ORGANIZATION": "your-organization-name"
      }
    }
  }
}

If you prefer authenticating with Azure CLI, you can configure the same MCP server without the PAT in the environment (PAT is optional). The server will use your Azure CLI credentials after you run az login.

Additional setup and start flow

Install dependencies and start the MCP server using the CLI-friendly configuration shown above. You typically install dependencies in your project and then start the MCP as part of your development workflow.

# Optional: install dependencies if you haven’t already
npm install

# Start the MCP server (from your project root)
npx azure-devops-wiki-mcp

Available tools

search_wiki

Search across wiki content using the Azure DevOps Search API. Requires organization, project, and searchText; optionally specifies a wikiId.

wiki_get_page_tree

Retrieve the hierarchical structure of wiki pages for a given wiki, with an optional depth limit.

wiki_get_page

Get the content of a specific wiki page by organization, project, wikiId, and page path or ID.

wiki_update_page

Update an existing wiki page or create a new one if it does not exist, using Markdown content.

list_wiki

List all wikis within a project, with optional organization and project filters.