Skip to main content

​
Getting Started

Connect Notion to give Blocks access to your workspace pages and databases. Once connected, Blocks can look up documentation, reference specs, and pull context from Notion when working in GitHub, Slack, Linear, and other platforms.
Blocks cannot be invoked from Notion. Notion is used as a data source only — Blocks reads from your Notion workspace to provide context when handling requests made elsewhere.

​
Setting Up the Notion Integration

Connect Notion via Settings > Integrations > Notion in the Blocks dashboard. OAuth connects your Notion workspace and links your user account.

​
What Blocks Can Do

Once your Notion workspace is connected, Blocks can:
  • Look Up Documentation: Find and reference internal docs, runbooks, and guides stored in Notion
  • Reference Specs and Requirements: Pull product requirements, design specs, and technical designs into context when implementing features
  • Search Pages and Databases: Search across your workspace to find relevant information for a given task
  • Provide Richer Context: Use Notion content to give more accurate, context-aware answers when you ask questions in GitHub or Slack

​
Using Notion in Requests

After connecting Notion, you can ask Blocks to reference your workspace content from any supported platform: 
@blocks implement this feature according to the spec in our Notion docs

@blocks check our Notion runbook and help me debug this issue

@blocks summarize the requirements for this project based on our Notion pages
Blocks will automatically search your Notion workspace for relevant content when it would help complete a request. You can also explicitly ask Blocks to look something up in Notion.

​
Best Practices

  • Organize Your Workspace: Well-structured Notion pages with clear titles make it easier for Blocks to find relevant content
  • Be Specific: Reference specific page names or topics when asking Blocks to look something up
  • Keep Docs Updated: Blocks reads your current Notion content — outdated pages may lead to outdated answers
  • Combine With Other Integrations: Notion works best alongside GitHub, Slack, or Linear, where Blocks can act on the context it finds

​
Next Steps

New to Blocks? Check out the Getting Started guide to learn the basics. Learn more about: