Skip to main content

Notion Resources

Notion resources allow you to connect your Notion workspace to Reeva, making your Notion pages and databases accessible as context for AI models.

Prerequisites​

Before creating a Notion resource, you need to:

  1. Connect your Notion account in the Accounts section
  2. Ensure you have access to the Notion page or database you want to expose

See Notion tool documentation for detailed instructions.

Creating a Notion Resource​

  1. Navigate to Resources in the left sidebar
  2. Click + New Resource
  3. Select Notion as the resource type
  4. Fill in the resource details:
    • Name: Descriptive name (e.g., project_roadmap)
    • Description: What this Notion content contains
  5. Select your Notion content using the built-in search:
    • Choose your connected Notion account (or create one)
    • Search your workspace by typing in the search box
    • Select a page or database from the results
  6. URI: Auto-generated based on your selection (e.g., notion://project-roadmap)

Selecting a Notion Page or Database​

The new search-based interface makes it easy to find and connect your Notion content:

1. Select Account​

Choose your connected Notion account from the dropdown menu.

  • If you haven't connected a Notion account yet, click "Create Account" to connect one
  • You can create multiple Notion accounts for different workspaces

2. Search Your Workspace​

Type in the search box to find pages or databases:

  • Results appear as you type (search-as-you-type)
  • Both pages and databases are shown with clear type indicators
  • See the last edited time to identify recent content
  • Results show page/database titles and icons

3. Select Your Content​

Click on a result to select it:

  • The resource subtype (Page/Database) is automatically set based on your selection
  • The resource name is auto-filled from the Notion title (you can edit it)
  • You'll see a preview of your selection with a link to open it in Notion

Resource Subtypes​

Notion Page​

Exposes a single Notion page and its content:

  • Page title
  • All text blocks
  • Nested blocks and subpages (limited depth)

Best for:

  • Documentation
  • Project overviews
  • Meeting notes
  • Knowledge base articles

Notion Database​

Exposes a Notion database and its entries:

  • All rows/entries in the database
  • Property values
  • Relations (linked databases)

Best for:

  • Project tracking
  • Product roadmaps
  • Task lists
  • Content calendars

Content Access​

Notion resources are fetched on-demand when an AI model requests them. This ensures the AI always has the latest content from Notion.

Caching​

  • Content is cached for 5 minutes to reduce API calls
  • After 5 minutes, fresh content is fetched from Notion
  • You can unlink and relink a resource to force a refresh

Permissions​

The Notion resource can only access content that your connected Notion account has permission to view. If the page or database is restricted, make sure your Notion integration has been granted access.

Example Use Cases​

Project Documentation​

Link your project's main Notion page:

  • Project goals and requirements
  • Technical specifications
  • Architecture decisions
  • Team contacts

Product Roadmap​

Expose your Notion roadmap database:

  • Upcoming features
  • Release timeline
  • Priority levels
  • Status updates

Company Wiki​

Share internal documentation:

  • Processes and procedures
  • FAQ pages
  • Technical guides
  • Onboarding docs

Meeting Notes​

Provide context from meeting notes:

  • Decision history
  • Action items
  • Discussion summaries

Linking to Servers​

After creating a Notion resource:

  1. Open the resource detail page
  2. In the Linked Servers section, select a server
  3. The Notion content is now accessible to AI clients

Content Format​

Notion content is converted to a structured text format when provided to AI models:

  • Pages: Formatted as Markdown with headings and structure preserved
  • Databases: Provided as JSON with properties and values

Limitations​

  • API Rate Limits: Notion API has rate limits; excessive requests may be throttled
  • Content Size: Very large pages or databases may exceed AI model context limits
  • Real-time: Content is fetched when requested, not streamed in real-time
  • Rich Media: Images and files in Notion are not currently included

Troubleshooting​

"Cannot access Notion page/database"​

  • Ensure your Notion account has access to the content
  • Check that the Notion integration is properly connected
  • Try refreshing the search results by changing the search query
  • Verify you selected the correct account in the resource configuration

"No search results found"​

  • Check that your Notion integration has been granted access to the pages/databases
  • Try searching with different keywords
  • Verify the content exists in your Notion workspace
  • Some pages may be in archived databases or nested deeply

Content Not Updating​

  • Wait for the 5-minute cache to expire
  • Unlink and relink the resource to force a refresh
  • Check that changes were saved in Notion

Missing Content​

  • Some Notion block types may not be fully supported
  • Complex database relations may be simplified
  • Check Notion permissions for the integration

Best Practices​

  • Start Small: Test with a single page before exposing large databases
  • Use Clear Titles: Notion page titles become part of the context
  • Organize Content: Well-structured Notion pages work best
  • Monitor API Usage: Be mindful of Notion API rate limits
  • Regular Review: Keep Notion content up-to-date and relevant
  • Access Control: Only connect accounts with appropriate permissions