mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
Cursor Agent
45 lines
2.9 KiB
Plaintext
45 lines
2.9 KiB
Plaintext
---
|
|
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", "Notion integration", "MCP", "knowledge base", "agent context"]
|
|
---
|
|
|
|
Connect your Notion workspace to the agent so it can search and read your Notion pages and databases when creating documentation updates. This gives the agent additional context from your team's knowledge base, product specs, and internal documentation stored in Notion.
|
|
|
|
## 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 install buttons for agent integrations." className="block dark:hidden" />
|
|
<img src="/images/agent/install-apps-dark.png" alt="The App settings section with install buttons for agent integrations." 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
|
|
|
|
When the Notion integration is enabled, the agent 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 writing or updating documentation.
|
|
- **Reference databases**: Pull structured data from Notion databases to inform documentation updates.
|
|
|
|
The agent uses Notion as a context source alongside your connected GitHub repositories and conversation history. When you prompt the agent, it can pull relevant information from Notion to produce more accurate and complete documentation.
|
|
|
|
## 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.
|
|
|
|
<Info>
|
|
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.
|
|
</Info>
|