Microsoft Learn CLI

Prefer Microsoft Learn MCP tools when they are available. Otherwise, use the Learn CLI instead of relying on training data for questions about Microsoft technologies. The CLI retrieves official Microsoft Learn documentation and code samples without requiring an MCP client.

npx @microsoft/learn-cli@latest search "<query>" --json
npx @microsoft/learn-cli@latest fetch "<url>"
npx @microsoft/learn-cli@latest code-search "<query>" --language <language> --json

When to Use

• Microsoft product concepts, architecture, tutorials, configuration, limits, quotas, or best practices
• Microsoft SDK, API, package, class, method, or command questions
• Code that uses Azure, .NET, Microsoft 365, Windows, Power Platform, Dynamics, or other Microsoft technologies
• Microsoft-specific errors, deprecated APIs, version migrations, or authentication guidance

Do not use this skill for unrelated programming concepts, business logic, or non-Microsoft products.

Documentation Workflow

1. Search with a specific query that includes the technology, version, platform, language, and task when relevant:

   npx @microsoft/learn-cli@latest search "Azure Functions Python v2 timeout configuration" --json
   

2. Use the most relevant result excerpts first. Fetch a Microsoft Learn URL only when the excerpt is insufficient or the user needs a complete tutorial, configuration reference, or API page:

   npx @microsoft/learn-cli@latest fetch "<url>"
   

3. For a long page, fetch only the relevant section or limit the returned content:

   npx @microsoft/learn-cli@latest fetch "<url>" --section "<heading>"
   npx @microsoft/learn-cli@latest fetch "<url>" --max-chars 5000
   

4. Answer from the retrieved content and cite the Microsoft Learn URLs used.

Code Workflow

Use code search before producing or fixing code that depends on a Microsoft SDK or API: