PluginInstalls cleanly
Build docs sites with Mintlify
Mintlify plugin
Mintlify's official plugin helps your assistant write and fix Mintlify docs sites, pages, navigation and components, and search Mintlify docs.
- Works with
- Claude Code, Codex CLI, Gemini CLI
- Good for
- Web developers, Daily work and research
What it does
Mintlify is a service for documentation websites. You write pages in MDX files, and Mintlify turns them into a docs site with search and navigation.
This plugin adds one skill, /mintlify:mintlify, with reference files on components, the docs.json config file, navigation and API docs, so your assistant writes pages that build correctly. It also connects a server that searches Mintlify's own documentation.
The newer version on main (from Mintlify's own marketplace) adds Mintlify Admin, which can make changes to your Mintlify project. It also adds more reference files, for example the mint CLI, writing style and customization.
Example prompts
- "Add a quickstart page and put it in the navigation."
- "Turn this README into a Mintlify docs page with tabs and code groups."
- "Why does my docs.json fail to build?"
- "Rewrite this page so it's shorter and easier for beginners."
How to install
/plugin install mintlify@claude-plugins-officialHow to use it
In your docs project ask: Add a quickstart page and put it in the navigation. The /mintlify:mintlify skill loads by itself for Mintlify work.
Check it works
In Claude Code, run /plugin and check that mintlify is installed, then run /mcp and check that the Mintlify server is connected. Ask "Which Mintlify components can I use for steps?"
Common problems
- You don't see Mintlify Admin — the directory version is older than main — install from Mintlify's marketplace:
/plugin marketplace add mintlify/mintlify-claude-plugin, then/plugin install mintlify@mintlify-marketplace— https://github.com/mintlify/mintlify-claude-plugin - Answers use old config names — the pinned reference files are older — update to the version on main — https://github.com/mintlify/mintlify-claude-plugin
Other assistants
- The README gives
npx skills add mintlify/mintlify-claude-pluginto install the skill. It installs the skill only, not the MCP servers. The README does not name Codex or Gemini CLI; we expect the skills tool to work with them (not tested).
What to watch out for
- Anthropic's directory pins commit acd6d2e (2026-04-06), 67 commits behind main (2026-10-26); that version has only the Mintlify docs-search server and 4 reference files (main has 18)
- On current main (Mintlify's own marketplace) a second server, Mintlify Admin (https://mcp.mintlify.com, sign-in needed), can change your Mintlify project, and its execute_code changes apply live; review before you approve
- The docs-search server has a submit_feedback tool that sends reports to Mintlify (main README)
- Hosting your docs on Mintlify needs a Mintlify account; Pro is a paid plan
Licence and author
- Licence
- MIT
- Author
- Mintlify
- Source code
- github.com/mintlify/mintlify-claude-plugin
How we tested it
We installed it on an empty test computer on 26 Oct 2026. Installed and started in a clean test system. Not yet used in a real AI session.
Not yet used on real work.
Technical details of the test
- Date
- 26 Oct 2026
- Method
- Intake sandbox run on 2026-10-26 in a clean container with no account: cloned the repository and checked its skill, agent and plugin files; installed mintlify@claude-plugins-official with the Claude Code command line.
Checked again on 26 Oct 2026
Alternatives
- Context7 — up-to-date docs for many libraries, not a docs-site builder
- MarkItDown MCP — turns files into Markdown
FAQ
- Q: Does it cost money? A: The plugin is MIT. Mintlify's pricing page lists a $0 Starter plan that includes an MCP server, and Pro at $450 a month billed yearly or $540 monthly, with a 14-day trial (checked 2026-10-26).
- Q: Do I need a Mintlify site? A: For the writing help, no, but it's built for Mintlify docs projects.
- Q: Which version do I get? A: From Anthropic's directory, the older pinned version; from Mintlify's marketplace, the latest.
Sources
- github.com/mintlify/mintlify-claude-plugin
- mintlify.com/docs
- mintlify.com/pricing