Mintlify Claude plugin

A Claude Code plugin that gives Claude a comprehensive reference for building Mintlify sites.

Installs a mintlify skill that Claude can invoke when working on Mintlify-powered sites.

The skill covers:

Components — Full syntax and props for all Mintlify components (callouts, cards, steps, tabs, accordions, code groups, fields, frames, and more)
Configuration — Complete docs.json settings reference including theme, colors, logo, fonts, navbar, footer, redirects, integrations, and custom CSS/JS
Navigation — All navigation patterns: groups, tabs, anchors, dropdowns, products, versions, and languages
API docs — OpenAPI and AsyncAPI setup, endpoint pages, API playground configuration
CLI — Common mint CLI commands and their key flags
Product context — An interview that records who your docs are for in .mintlify/product-brief.md in your project, so later sessions don't ask again

This plugin includes two Mintlify MCP servers that are activated automatically when you install the plugin.

Mintlify Search (https://mintlify.com/docs/mcp) — Read-only access to Mintlify's published documentation. Use to look up components, config options, guides, and other reference material. Its submit_feedback tool sends a report about an incorrect or outdated docs page to Mintlify.
Mintlify Admin (https://mcp.mintlify.com) — Write access to your Mintlify project. Requires OAuth on first use. Content edits go to a session branch and reach your site through a pull request. Project-level changes made through execute_code, such as workflows, settings, members, and integrations, apply immediately to your live project, so the skill tells Claude to confirm them with you first.

To install the skills in this repo:

npx skills add mintlify/mintlify-claude-plugin

To install as a Claude Code plugin:

/plugin marketplace add mintlify/mintlify-claude-plugin
/plugin install mintlify@mintlify-marketplace

Invoke with /mintlify:mintlify or let Claude use it automatically when working on Mintlify projects.

The skill loads a concise core reference and routes to detailed reference files only when the task requires them:

Reference file	Contents
`reference/components.md`	All component syntax, props, and examples
`reference/configuration.md`	Full `docs.json` schema and frontmatter fields
`reference/navigation.md`	Navigation patterns and when to use each
`reference/api-docs.md`	API documentation setup and playground config
`reference/cli.md`	CLI commands and flags
`reference/product-context.md`	Product brief interview and how the brief is reused

MIT

Mintlify