Claude Mintlify connectorWhat Claude can do in your Mintlify account.
The Claude Mintlify connector exposes 15 tools. 5 read your docs and session, 10 write: pages, navigation, configuration, branches and pull requests. Here is how a session works, what Claude can ship, and what can go live without review.
Verified Trustpilot reviews · AI, automation & growth agency
What changes for a docs team
A product change ships and some pages are suddenly out of date. With this connector, you describe the fix to Claude and it works inside your Mintlify project: it finds the pages, edits them on a dedicated branch, shows you the diff, then opens a pull request. Mintlify adds that every edit buffers on that session branch, so nothing touches your deploy branch before a save.
Fix outdated pages after a release. A parameter was renamed: search finds every line that still uses the old name, edit_page corrects each page, and diff shows the result before anything leaves the branch.
Reorganize a section. The API reference has grown messy: list_nodes walks the navigation tree, create_node adds a new group, and move_node slots pages into it.
Ship it for review. Once the branch looks right, save opens a pull request, or discard_session drops everything if you change your mind.
What Claude cannot promise. Edits sit on a session branch until saved, but depending on your project settings, a save can merge straight away. Claude works with the role your Mintlify account has, so admin-only settings need an admin. And nothing triggers on its own: a new release does not wake Claude up. Scheduled or event-driven jobs belong to automation tools, a separate job you will find from the Integrations hub.
The vocabulary in one minute
Five words you will meet while connecting Mintlify.
- Connector
- The link you set up once between Claude and an account you already have, so Claude can work in it while it answers you.
- Tool
- One named thing a connector lets Claude do in that account. Claude picks the tools it needs; the directory sheet lists every one by name.
- Authorization
- Mintlify's own sign-in screen, where you grant the access Claude will use. Granted once per person, revocable from Mintlify's settings.
- Approval
- The confirmation Claude waits for before it goes ahead with something that changes your account, shown in the conversation when it matters.
- MCP
- The shared standard connectors are built on: it is what lets an assistant like Claude talk to an outside service.
Connect Mintlify to Claude in three steps
- 01
Find Mintlify
In Claude, open Customize, then Connectors, and find Mintlify in the list. On a Team or Enterprise workspace, an Owner or Primary Owner enables the connector for the organization before members can sign in.
- 02
Sign in to Mintlify
Click Connect on its row and complete the login in the window Mintlify opens. If the connection ever breaks, use Disconnect, then connect again from the same row.
- 03
Check what you grant
Read the authorization screen before confirming. It is Mintlify's, not Claude's, and it sets what the access covers. You can revoke it later from your Mintlify dashboard.
The 15 tools, grouped by what they do
Mintlify gives Claude 15 tools: 5 that read your account, 10 that change something in it.
Two groups: what Claude reads, and what it changes in your project. Tool names stay in English, exactly as Claude shows them.
- 5 read
- 10 write
What Claude reads (5)
5 toolsFive tools that look at pages, navigation and the current session without touching them.
read
Fetches the full MDX source of any page on the session branch, from a file path or an identifier. What it returns is the version on the session branch, not the published one.
search
Finds lines matching a substring or a regular expression across all pages of the project, so Claude knows every place a term appears.
list_nodes
Lists the navigation tree with optional filters. It shows how pages, groups and tabs are arranged, which is the map Claude needs before any restructuring tool runs.
get_session_state
Shows the current branch, the files already edited in this session and the pending navigation diff, a quick status check in the middle of a long job.
diff
Lists every difference between the session branch and your deploy branch, so you see exactly what would ship before anything is saved.
What Claude changes (10)
10 toolsTen tools that create a branch, edit content or ship it. No source describes a confirmation specific to them, so the general rule below applies.
checkout
Approval: see the ruleBinds the session to a branch of a given project, creating a fresh admin-mcp branch from that project's deploy branch. Calling it again switches which project's session is active.
save
Approval: see the rulePushes the session's work to Git, opening a pull request or committing to the session branch. If your project lets the agent push to main and the branch is unprotected, Mintlify merges it at once.
discard_session
Approval: see the ruleThrows away the session and every in-flight edit. Nothing from that session reaches your deploy branch.
edit_page
Approval: see the ruleApplies a targeted edit to one page, leaving the rest of its content as it was. The change lands on the session branch.
write_page
Approval: see the ruleOverwrites a page's full MDX content in one go, rather than patching a passage. The new version sits on the session branch until a save.
create_node
Approval: see the ruleAdds a page, group, tab, anchor, version, language, product or dropdown to the navigation. Mintlify warns that invalid nodes can be dropped from the published navigation, so errors get fixed before a save.
update_node
Approval: see the ruleModifies a node's properties in place: renaming a group, swapping an icon or setting a default version, without moving anything.
move_node
Approval: see the ruleMoves a node elsewhere in the navigation, including renaming a page's path, which also changes the address readers land on.
delete_node
Approval: see the ruleTakes a node out of the navigation. The removal waits on the session branch like any other edit.
update_config
Approval: see the ruleModifies the project's docs.json: theme, navigation roots, integrations and SEO settings. On protected settings, Mintlify requires an admin role on the project.
What Claude asks before acting
By default, Claude stops and asks before every action it takes on an account for you. On Mintlify, the branch adds a second safety net, unless your project lets saves merge directly.
On Team and Enterprise, workspace owners decide whether members may let some actions through without a prompt, and can limit what any connector may do for the whole organization, keeping reads and closing writes for example. Claude inherits your Mintlify role and nothing more: Mintlify says the OAuth session carries your dashboard permissions. The official per-tool label, read-only versus write and delete, only appears in a connected account's settings.
Which plans include it
None of the 819 sheets in the official directory shows plan availability. That answer, connector by connector, is not published anywhere.
The general rule is published: remote connectors are open to all users on Claude, Cowork, Claude Desktop and mobile. On Team and Enterprise, an Owner or Primary Owner turns a connector on for the organization before members can connect. Your Mintlify role and Git access are separate requirements, set on Mintlify's side. For the current state on your account, check the connector's sheet in the official directory.
Where this connector stops
A connector is not an automation. Claude calls these tools while it answers you; nothing starts when code merges or a release goes out.
Only Mintlify documents this connector: Claude's help center has no page for it, so the limits below are the publisher's. Mintlify's page also describes tools that are not on the directory sheet; this page only covers the fifteen listed. The tool list is an observed floor, not a ceiling. The directory badge is not a security audit, and Anthropic writes on every sheet that it does not choose a publisher's tools. For other connectors and automation pages, browse the Integrations hub.
Need help connecting Mintlify to Claude?
A person reads every message.
