Add Notion MCP integration docs for the agent

agent/index.mdx

@@ -48,6 +48,9 @@ Add the agent to your Slack workspace.
 <Card title="Connect Linear" horizontal icon="linear" href="/agent/linear">
 Add the agent to your Linear workspace.
 </Card>
+<Card title="Connect Notion" horizontal icon="file-lines" href="/agent/notion">
+Give the agent access to your Notion workspace.
+</Card>
 <Card title="Customize behavior" horizontal icon="wrench" href="/agent/customize">
 Configure the agent with an `AGENTS.md` file.
 </Card>

agent/linear.mdx

@@ -11,8 +11,8 @@ Connect your Linear workspace to the agent to make documentation updates from Li
 1. Go to the [Agent](https://dashboard.mintlify.com/products/agent) page in your dashboard.
 2. In the "Agent settings" section, click **Install Linear app**.
   <Frame>
-    <img src="/images/agent/install-apps-light.png" alt="The App settings section with the Slack and Linear install buttonsi." className="block dark:hidden" />
-    <img src="/images/agent/install-apps-dark.png" alt="The App settings section with the Slack and Linear install buttons." className="hidden dark:block" />
+    <img src="/images/agent/install-apps-light.png" alt="The App settings section with the Slack, Linear, and Notion install buttons." className="block dark:hidden" />
+    <img src="/images/agent/install-apps-dark.png" alt="The App settings section with the Slack, Linear, and Notion install buttons." className="hidden dark:block" />
   </Frame>
 3. Follow the Linear prompts to authorize the Mintlify app in your workspace.
 

agent/notion.mdx

@@ -0,0 +1,42 @@
+---
+title: "Connect Notion to the agent"
+description: "Give the agent access to your Notion workspace to reference pages and databases when updating documentation."
+keywords: ["Notion", "integration", "knowledge base", "context"]
+---
+
+Connect your Notion workspace to the agent so that it can search your Notion content and use it as context when creating documentation updates. The additional context from your team's knowledge base, product specs, and internal documentation stored in Notion helps the agent create more accurate and complete documentation.
+
+## Connect your Notion workspace
+
+1. Go to the [Agent](https://dashboard.mintlify.com/products/agent) page in your dashboard.
+2. In the "Agent settings" section, click **Install Notion app**.
+  <Frame>
+    <img src="/images/agent/install-apps-light.png" alt="The App settings section with the Slack, Linear, and Notion install buttons." className="block dark:hidden" />
+    <img src="/images/agent/install-apps-dark.png" alt="The App settings section with the Slack, Linear, and Notion install buttons." className="hidden dark:block" />
+  </Frame>
+3. Follow the prompts to authorize Mintlify to access your Notion workspace.
+4. In Notion's authorization screen, select which pages and databases to share with Mintlify.
+
+## What the agent can do with Notion
+
+The Notion integration uses Notion's [MCP tools](https://developers.notion.com/guides/mcp/mcp-supported-tools#mcp-tools) to search and read your workspace content.
+
+Your content in Notion becomes additional context for the agent to use when generating documentation.
+
+When the agent has access to your Notion workspace, it can:
+
+- **Search Notion**: Find relevant pages and databases in your connected Notion workspace based on the context of your request.
+- **Read Notion pages**: Access the content of Notion pages to use as reference material when generating documentation.
+- **Reference databases**: Pull structured data from Notion databases to inform documentation updates.
+
+## Use cases
+
+- **Sync product specs to docs**: Reference product requirement documents and design specs stored in Notion when writing feature documentation.
+- **Document from meeting notes**: Point the agent to meeting notes or decision logs in Notion to draft documentation based on team discussions.
+- **Pull from internal knowledge bases**: Use internal wikis and knowledge bases in Notion as source material for public-facing documentation.
+
+## Best practices
+
+- **Scope access carefully**: Only grant access to the Notion pages and databases that contain information relevant to your documentation.
+- **Provide specific references**: When prompting the agent, mention the specific Notion page or database you want it to reference for best results.
+- **Review generated content**: Always review pull requests to ensure information from Notion is appropriately adapted for your public documentation.

agent/slack.mdx

@@ -13,8 +13,8 @@ keywords: ["Slack integration", "Slack bot", "team collaboration", "agent integr
 1. Go to the [Agent](https://dashboard.mintlify.com/products/agent) page in your dashboard.
 2. In the "Agent settings" section, click **Install Slack app**.
   <Frame>
-    <img src="/images/agent/install-apps-light.png" alt="The App settings section with the Slack and Linear install buttonsi." className="block dark:hidden" />
-    <img src="/images/agent/install-apps-dark.png" alt="The App settings section with the Slack and Linear install buttons." className="hidden dark:block" />
+    <img src="/images/agent/install-apps-light.png" alt="The App settings section with the Slack, Linear, and Notion install buttons." className="block dark:hidden" />
+    <img src="/images/agent/install-apps-dark.png" alt="The App settings section with the Slack, Linear, and Notion install buttons." className="hidden dark:block" />
   </Frame>
 3. Follow the Slack prompts to install the `mintlify` app in your workspace.
 4. Follow the Slack prompts to link your Mintlify account to your Slack workspace.

docs.json

@@ -94,6 +94,7 @@
                     "pages": [
                       "agent/slack",
                       "agent/linear",
+                      "agent/notion",
                       "agent/workflows",
                       "agent/customize",
                       "agent/effective-prompts",