Notion Tool
The Notion Tool allows DinoAI to search your Notion workspace and read page content and comments, bringing your team's documentation, specs, and project notes directly into your development workflow.
This tool connects your Notion knowledge base to the Code IDE, enabling DinoAI to surface relevant pages, extract structured content, and incorporate team feedback β from sprint requirements to inline review comments.
Requires Notion integration. Before using this tool, make sure you've connected your Notion account in Paradime. See Connecting Notion to Paradime for setup instructions.
Capabilities
The Notion Tool exposes three underlying operations:
search_notion searches your Notion workspace by text query, returning matching pages and databases with their IDs, titles, types, and URLs. You can optionally filter results by type (page or database) and limit the number of matches returned.
fetch_notion_page fetches the full content of a specific Notion page by ID. It retrieves both the page metadata β title, URL, and last-edited time β and the block content, converting it to clean markdown for DinoAI to reason over.
get_notion_page_comments fetches all comments on a Notion page, including both page-level comments and inline comments attached to individual blocks. Results are returned with page_comments and inline_comments sections clearly separated.
Using the Notion Tool
Open DinoAI in the right panel of the Code IDE
Describe what you're looking for or provide a specific Notion page ID or URL
Add your prompt describing what you want DinoAI to do with the content or comments
Grant permission when DinoAI asks to access your Notion workspace
Review and implement DinoAI's suggested actions
Example Use Cases
Finding a Relevant Spec Page
Prompt
Result: DinoAI queries your Notion workspace, identifies the most relevant page, and extracts a structured summary you can apply directly to your dbt models.
Turning a Notion Page into Implementation Steps
Prompt
Result: DinoAI retrieves the full page content, identifies requirements and business logic, and breaks them down into a sequenced list of development tasks you can work through in the IDE.
Incorporating Review Feedback
Prompt
Result: DinoAI fetches both page-level and inline comments, consolidates the open feedback items, and surfaces them so you can address reviewer notes before finalizing your implementation.
Working with Other Tools
The Notion Tool works well alongside DinoAI's other capabilities to support your full development workflow:
Combine with the Terminal Tool to scaffold models and run dbt commands based on requirements extracted from Notion
Combine with the Linear Tool or Jira Tool to cross-reference Notion specs against linked tickets
Use alongside Git Lite to commit and push your changes before creating a pull request
Best Practices
Share pages correctly β Ensure the Notion pages you want to reference are accessible to the account connected in Paradime.
Use well-structured pages β DinoAI works best with pages that use clear headings, toggles, and callouts rather than large blocks of unformatted text.
Be specific in your prompt β Tell DinoAI exactly what you want extracted or produced, such as model names, test definitions, or a summary of open comments.
Verify the output β Always review DinoAI's interpretation of your Notion content before implementing, especially for pages with complex nested blocks or extensive inline comments.
Last updated
Was this helpful?