How to connect Mintlify to Grok Bot

Connect Grok Bot to Mintlify MCP. Search docs for api rate limits, find authentication code examples in docs, and more using natural language, with authentication handled for you.

Mintlify MCP logoMintlify MCP
Dcr Oauth

Mintlify MCP is a documentation platform for projects and developer docs. Access and search your project docs with fast, contextual results.

19 Tools

Introduction

Grok is xAI's assistant, and its bot builder lets you create a personal agent that holds context, runs skills, and connects to the apps you already use through plugins.

This guide explains how to connect Mintlify to a Grok bot using Composio Connect, which handles OAuth, token refresh, and reliability so you do not have to. You add Composio as a plugin, authenticate once, then ask your bot to work with Mintlify in plain language.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Mintlify MCP with

Why use Composio?

Composio exposes 1,700+ apps to your Grok bot through a single connection, so you get:

  • Connect to 1,700+ apps with on-demand tool loading, so you do not fill your context window with unnecessary tool definitions.
  • Use programmatic tool calling through a remote workbench, letting the model write its own code to handle complex tool chaining. This reduces back-and-forth for frequent tool calls.
  • Handle large tool responses outside the model context to keep conversations lean.

Connecting Mintlify to Grok Bot

Once Grok Bot is set up, you connect Mintlify entirely from its interface, and the whole flow takes under a minute.

Set up Grok Bot

Get access. Grok Bot is included with Cursor Ultra, Cursor Premium Teams, and SuperGrok Heavy. Get the desktop app for macOS or Windows from x.ai/bot and sign in. An iPhone companion app is also available, and your bots sync across devices.

Create a bot. Pick a suggested role or define your own, then give it a short name, one primary job, and a short description of how it should work. Focused bots work best, because a clear role gives the bot more useful context over time.

Connect Mintlify

1. Add the Composio plugin

Click the button. The Composio listing on x.ai opens and launches Grok Bot for you. If the app does not open on its own, click Add to Grok Bot.

Add to Grok Bot

Composio for Grok Bot listing on x.ai with the Add to Grok Bot button

Grok Bot opens the Composio plugin, showing its connector and skills. Click Add.

Composio plugin sheet in Grok Bot with the Add button

2. Authenticate

Go to the Installed section and click the Composio entry. You'll see its connector and skills listed.

Installed Composio plugin showing the Authenticate button

Click Authenticate. You'll be taken to the Composio consent screen. Review the access it requests and click Authorize. Composio handles the OAuth handshake for you, so you never touch API keys or tokens.

Composio authorization screen with Authorize and Deny

3. Connect your Mintlify account

Back in the chat, ask your bot to connect to Mintlify or give it any Mintlify task.

For example, ask it to:

  • "Search docs for API rate limits"
  • "Find authentication code examples in docs"
  • "List pages referencing onboarding developer guide"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in your Grok bot, and your Mintlify account is ready to use.

What is Grok Bot?

Grok is xAI's assistant, available as a chat interface and a bot builder for creating personal agents that run skills and connect to external apps.

With Composio Connect, your Grok bot can securely access apps like Mintlify through MCP without you sharing account credentials directly with the agent.

What is the Mintlify MCP server, and what's possible with it?

The Mintlify MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Mintlify account. It provides structured and secure access to your documentation projects, so your agent can search and read pages, edit content, manage navigation, update configuration, and save changes on your behalf.

  • Documentation search and reading: Have your agent search every page for text or patterns and read the full content of any matching documentation page.
  • Page creation and editing: Direct your agent to write complete pages, replace specific page content, and save documentation changes to Git.
  • Navigation management: Let the agent list, create, update, move, or delete pages and sections in your documentation navigation.
  • Branch and editing session control: Instruct your agent to list available branches, open an editing session for a deployment, review changed files and navigation updates, compare work with the main branch, or discard the session.
  • Documentation configuration: Have your agent update top-level documentation settings outside the navigation structure.

Way Forward

Now that Mintlify is connected, extend your setup by connecting the other apps you already use every day, so your Grok bot can run true cross-app workflows end to end.

  • Connect Calendar to turn threads into scheduled meetings automatically.
  • Connect Slack or Teams to post summaries, approvals, and alerts where your team works.
  • Connect Notion, Linear, Jira, or Asana to convert requests into tickets, tasks, and docs.
  • Connect Drive, Dropbox, or OneDrive to fetch, file, and share attachments without manual steps.

Start with one workflow you do repeatedly, then keep adding apps as you find new handoffs. With everything behind a single connection, your bot can coordinate multiple tools safely and reliably in one conversation.

TOOLS

Supported Tools

Every Mintlify MCP action and event your agent gets out of the box.

Checkout

Select a deployment and open its editor session in one call.

Create node

Insert a node into the navigation tree under `parentId` (null = root).

Delete node

Remove a node and its subtree from the navigation tree by `nodeId`.

Diff

Returns the list of changes between current session and main.

Discard session

End the session without creating a PR

Edit page

String-replace edit on a page Y.Doc body.

Execute code

Run TypeScript/JavaScript against the Admin MCP dashboard SDK inside a sandboxed Cloudflare isolate.

Get session state

Get current session state including branch name, edited files, and nav diff

List branches

List all git branches available for a deployment before or after checkout.

List deployments

List the deployments this connection is authorized for, returning each `{ subdomain, name }`.

List nodes

List navigation nodes with optional filters over the current branch nav tree.

Move node

Reposition a node in the navigation tree by nodeId.

Read

Read the full MDX content of a single page on the current branch.

Save

Flush branch to git.

Search

Find lines matching a substring or regex across every page on the current branch.

Search code operations

Lexical (BM25) search over the Admin MCP code-mode SDK.

Update config

Update any top-level `docs.json` field except `navigation` (use the navigation tree tools for that).

Update node

Update a navigation node's properties in place by nodeId — no repositioning.

Write page

Full overwrite of a page Y.Doc content.

FAQ

Frequently asked questions

Start with Mintlify MCP.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Mintlify MCP tool your agent needs.Free to start.

Start building