Connect Notion to Your AI Agent

Ask AI to find workspace pages, extract the important details, and turn your notes into organized documents.

27 tools OAuth / API key

Try a Notion Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Notion

Find and Summarize Documents

Search for a page and read its content to extract a focused summary.

/oo Notion: Find the project kickoff page and summarize its goals, owners, and deadlines.

Turn Notes into Pages

Ask AI to structure your notes and create a page under a specified parent.

/oo Notion: Organize these meeting notes into decisions and next steps, then create a page under our project page.

Add Updates to Existing Pages

Read an existing page and append the update you specify.

/oo Notion: Add these weekly progress notes to the project page, keeping the existing content.

Start Working with Notion

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Notion

    Authorize your Notion account and select the pages to share. An internal integration secret is also supported.

    Connect Notion →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • Access to a Notion workspace and the pages you want to use.
  • Share the required pages with the integration. A connection does not automatically grant access to every page in a workspace.

Notion Tools

Use Notion pages, databases, and comments as sources and destinations for AI tasks. Access is limited to content shared with the connection.

Find and Read Pages

Search accessible pages and read their content as Markdown for summaries and reference checks.

Create and Edit Content

Create pages, update their text, or append blocks to existing documents.

Work with Databases

Query data sources with filters and sorting, create records, and update page properties.

Read and Add Comments

Read unresolved comments or add comments to pages with the required integration permissions.

27 tools

Search

Search Notion pages and data sources with optional filter, sort, and pagination controls.

notion.search

Get Page

Get a Notion page together with its first-level child blocks. This is a repo-level aggregate helper over page retrieval plus block-children listing.

notion.get_page

Create Page

Create a Notion page under a parent page, data source, or workspace-level private area. Use parentId + title for a simple child page under an existing page. Use parent with an official Notion parent payload for advanced cases: { page_id: "..." }, { data_source_id: "..." }, or { workspace: true } for OAuth public integrations. When parent is provided, do not use the top-level title field; provide the page title through properties.title instead. Internal integration secrets usually cannot create workspace-level private pages and should use a parent page or data source.

notion.create_page

Update Page

Update a Notion page's properties, title, icon, cover, trash status, or locked state.

notion.update_page

Move Page

Move a Notion page under another page or under a data source through the official page move API.

notion.move_page

Append Block

Append a single paragraph block to a Notion page. This is a simplified compatibility helper over `append_block_children`.

notion.append_block

Retrieve Page

Retrieve a Notion page's properties and metadata by page ID. This does not include child block content.

notion.retrieve_page

Retrieve Page Markdown

Retrieve a Notion page or block subtree rendered as enhanced Markdown through the official page markdown API.

notion.retrieve_page_markdown

Update Page Markdown

Update a Notion page's content as enhanced Markdown through the official page markdown API.

notion.update_page_markdown

Retrieve Page Property

Retrieve a specific property item from a Notion page by page ID and property ID. Title, rich_text, relation, and people properties return the paginated list response with type property_item.

notion.retrieve_page_property

List Users

List users in the Notion workspace with pagination.

notion.list_users

Retrieve User

Retrieve a Notion user by user ID.

notion.retrieve_user

Retrieve Block

Retrieve a Notion block by block ID.

notion.retrieve_block

List Block Children

List the direct child blocks under a Notion block with pagination.

notion.list_block_children

Append Block Children

Append raw Notion child blocks to an existing parent block, using the official block-children append API.

notion.append_block_children

Update Block

Update a Notion block using raw block fields, including block-type payloads and optional trash state.

notion.update_block

Delete Block

Archive a Notion block through the official delete endpoint.

notion.delete_block

Create Database

Create a Notion database container under a parent page or workspace, optionally with an initial data source.

notion.create_database

Retrieve Database

Retrieve a Notion database's metadata and schema by database ID.

notion.retrieve_database

Update Database

Update a Notion database container's parent, title, description, icon, cover, inline display, trash status, or locked state.

notion.update_database

Create Data Source

Create a Notion data source under a parent database with a properties schema.

notion.create_data_source

Retrieve Data Source

Retrieve a Notion data source by data source ID.

notion.retrieve_data_source

Update Data Source

Update a Notion data source's title, icon, properties schema, parent, or trash status.

notion.update_data_source

Query Data Source

Query a Notion data source with filters, sorts, pagination, and optional property filtering.

notion.query_data_source

List Data Source Templates

List templates available on a Notion data source.

notion.list_data_source_templates

List Comments

List unresolved comments on a Notion page or block. Requires the read comments capability.

notion.list_comments

Create Comment

Create a comment on a page or block through parent, or reply through discussion_id. Requires insert comments; without read comments, only object and id are returned.

notion.create_comment

Work Across Apps

Save Email Decisions in Notion

Combine Gmail messages into a project note with links back to the source emails.

Frequently Asked Questions

What can an AI assistant do with Notion?

It can find and summarize accessible pages, turn notes into documents, query databases, and update content. Specify the source pages and where new content should be saved.

Can I connect with an internal integration secret?

Yes. The integration supports both OAuth and an internal integration secret. Choose the method appropriate for your workspace.

Can AI read every page in my workspace?

Only pages accessible to the connection can be used. Check page sharing and integration permissions if content is missing.

Can I turn Gmail messages into Notion notes?

Yes, when both accounts are connected with the required permissions. Specify the messages to read and the parent Notion page for the new notes.

Do I need Notion AI to use this integration?

This integration uses Notion’s API through your authorized connection. The assistant in your AI product processes the content; it does not call Notion AI.

Connect Notion

About Notion ↗