MCP serverInstalls cleanly
Search Microsoft's official docs
Microsoft Learn MCP Server
A free connector from Microsoft that lets your assistant search and read Microsoft's official docs before it answers, with no account or API key.
- Works with
- Claude Code, Codex CLI, Gemini CLI
- Good for
- Daily work and research, Web developers
What it does
AI assistants sometimes answer from old memory and invent settings or commands that do not exist. This connector gives your assistant a direct line to Microsoft Learn, the site where Microsoft publishes its official technical documentation. The assistant can look things up first.
It adds three tools. One searches the docs, one reads a full docs page, and one finds official code examples. You do not call them yourself. You ask your question as usual, and the assistant uses the tools when the topic is a Microsoft product such as Windows, Azure, .NET, PowerShell or Microsoft 365.
It is free, and there is nothing to sign up for. The README says: "No API keys, no logins, no sign-ups required."
Read this first. In Claude Code it comes as a plugin from Anthropic's official directory. The plugin also adds three skills: microsoft-docs for questions, microsoft-code-reference for code, and microsoft-skill-creator, which writes new skills for a Microsoft product. Two things happen without a request from you:
- Claude uses them by itself. The skill descriptions tell Claude to use them for Microsoft questions "even if they don't mention" the docs.
- A fallback can run a program. If the connector does not answer, the skills tell the assistant to run
npx @microsoft/learn-cli. This downloads Microsoft's command-line tool from npm and runs it on your computer.
Who it is for
Anyone who asks an assistant about Windows, PowerShell, Azure, .NET or other Microsoft products and wants answers that match Microsoft's current documentation.
Example prompts
- "How do I set up a scheduled task in Windows? Check the Microsoft docs."
- "What does this PowerShell error mean? Look it up in Microsoft Learn."
- "Find the official steps to create an Azure storage account and summarise them."
- "Is this the current way to do it, or is it outdated? Check the Microsoft docs."
How to install
/plugin install microsoft-docs@claude-plugins-officialHow to use it
Ask a Microsoft question and add 'check the Microsoft docs', for example: How do I set up a scheduled task in Windows? Check the Microsoft docs.
Other assistants
Codex CLI (from the README):
codex mcp add "microsoft-learn" --url "https://learn.microsoft.com/api/mcp"Gemini CLI has no add command in the README. Add this block inside mcpServers in .gemini/settings.json:
"Microsoft Learn MCP Server": {
"httpUrl": "https://learn.microsoft.com/api/mcp"
}We have not tested the Codex and Gemini routes.
Check it works
- In Claude Code, run
/mcpand look for a server withmicrosoft-learnin its name. The MCP docs say a working server shows✔ Connected. - Type
/microsoft-docs:and look for the three skills, for example/microsoft-docs:microsoft-docs. - Ask one of the example prompts and watch for a Microsoft docs search in the tool calls.
Common problems
- "HTTP status 405" when you open the address in a browser — the address is for MCP clients, not browsers — use it only inside Claude Code, Codex or Gemini CLI (README).
- The assistant does not use the tools — some models skip MCP tools by default — say "check the Microsoft docs" in your request, or add a line to your note file (CLAUDE.md, AGENTS.md or GEMINI.md), as the README's troubleshooting section suggests.
- No results — the question is too vague — rephrase with more specific product terms (README).
What to watch out for
- Sends data to Microsoft: your search questions and the pages the assistant asks for go to Microsoft's hosted server at learn.microsoft.com
- The Claude Code plugin also adds three skills. Their descriptions tell Claude to use them for any Microsoft question, even if you do not mention the docs
- If the connector does not answer, the skills tell the assistant to run npx @microsoft/learn-cli instead, which downloads and runs Microsoft's command-line tool from npm (SKILL.md files)
- The microsoft-skill-creator skill writes new skill files to your computer when you ask it to make a skill
- It only covers Microsoft's own technical documentation; for anything else your assistant still uses its normal knowledge
- Use is under the Microsoft Learn Terms of Use (linked from the README)
Licence and author
- Licence
- CC-BY-4.0
- Author
- Microsoft (MicrosoftDocs)
- Source code
- github.com/MicrosoftDocs/mcp
How we tested it
We installed it on an empty test computer on 21 Oct 2026. Installed and started in a clean test system. Not yet used in a real AI session.
Not run: "codex mcp add "microsoft-learn" --url "https://learn.microsoft.com/api/mcp"" (not a form the sandbox runs). No docs search was run. Not yet used on real work.
Technical details of the test
- Date
- 21 Oct 2026
- Method
- Intake sandbox run on 2026-10-21 in a clean container with no account: cloned the repository and checked its skill, agent and plugin files; installed microsoft-docs@claude-plugins-official with the Claude Code command line.
Checked again on 21 Oct 2026
Alternatives
- Context7 — up-to-date docs for many programming libraries, not only Microsoft.
- Cloudflare MCP servers — the same idea for Cloudflare's documentation.
- Exa MCP — general web search across many sites, not only official docs.
FAQ
Does it cost anything? No. The README says it is free and needs no key or login.
Does it work in Gemini CLI? Yes, but by hand: add the settings block shown under "Other assistants".
Is it only for programmers? Mostly technical docs, but it also helps with Windows, PowerShell and admin questions.
Can it change anything on my computer?
The connector only searches and reads documentation. The skills can do more: the fallback runs Microsoft's command-line tool with npx, and microsoft-skill-creator writes skill files when you ask for a skill.
Sources
- github.com/MicrosoftDocs/mcp
- github.com/MicrosoftDocs/mcp/blob/main/skills/microsoft-docs/SKILL.md
- github.com/anthropics/claude-plugins-official/blob/main/.claude-plugin/marketplace.json
- learn.microsoft.com/legal/termsofuse
- code.claude.com/docs/en/mcp