Skip to main content
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 page in your dashboard.
  2. In the “Agent settings” section, click Install Notion app.
The App settings section with the Slack, Linear, and Notion install buttons.
  1. Follow the prompts to authorize Mintlify to access your Notion workspace.
  2. 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 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.