# 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.

{% hint style="info" %}
Requires Notion integration. Before using this tool, make sure you've connected your Notion account in Paradime. See [Connecting Notion](https://docs.paradime.io/app-help/documentation/integrations/code-ide/notion) to Paradime for setup instructions.
{% endhint %}

### 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

1. Open DinoAI in the right panel of the Code IDE
2. Describe what you're looking for or provide a specific Notion page ID or URL
3. Add your prompt describing what you want DinoAI to do with the content or comments
4. Grant permission when DinoAI asks to access your Notion workspace
5. Review and implement DinoAI's suggested actions

### Example Use Cases

#### Finding a Relevant Spec Page

**Prompt**

```
Search Notion for our data modeling standards and summarize the key rules.
```

**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**

```
Fetch Notion page 1abc... and turn it into implementation steps.
```

**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**

```
Get all comments on Notion page 1abc... and summarize the outstanding feedback.
```

**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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.paradime.io/app-help/documentation/dino-ai/tools-and-features/notion-tool.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.