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-official

How 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

Other assistants

  • The README gives npx skills add mintlify/mintlify-claude-plugin to 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.

Test level

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