Notion

AI agents can help you search, read, and edit Notion in plain language, no messy IDs. Here’s what you can do, with examples.

1. Work with pages

Create, open, update, archive, and restore pages.

Examples:

  • Create a new page in the database “Company OKRs” titled “Quarterly OKRs”, set 📊 as the icon, and add a paragraph “Draft goals for Q2.”

  • Get details for the page “Quarterly OKRs”.

  • Update the page “Quarterly OKRs”, set the “Status” property to “In Progress”, and set the icon to ✅.

  • Archive the page “Meeting Notes”.

  • Restore the archived page “Meeting Notes”.

  • Search for pages containing “Project Plan”.

2. Page properties

Read a specific property on a page.

Examples:

  • Retrieve the “Status” property value for the page “Quarterly OKRs”.

  • Retrieve the “Owner” property for the page “Project Plan”.

3. Blocks

Append, read, update, or delete content blocks.

Examples:

  • Append a paragraph “Next steps, finalize budget” to the page “Quarterly OKRs”.

  • Get the first 50 child blocks of the page “Project Kickoff”.

  • Update a paragraph in “Project Kickoff” to say “Project kickoff is confirmed for next Monday.”

  • Delete a checklist block from “Project Kickoff”.

4. Databases

Create databases, read schemas, and run filtered queries.

Examples:

  • Create a database under the page “Team Home” titled “Team Tasks” with properties, Task Name, Status with values To Do, In Progress, Done, and Due Date.

  • Retrieve the schema for the database “Team Tasks”.

  • Update the database “Team Tasks”, change the title to “Team Projects”, add a description “Tracking all active and completed projects”, and add a “Priority” select.

  • Query the database “Team Tasks” for items where Status is “In Progress”, sort by Due Date ascending, return 20 results.

5. Users

List everyone in the workspace or fetch one person.

Examples:

  • List all users in my workspace.

  • Get details for the user named “Jane Doe”.

  • Get details for me, the current authenticated user.

6. Comments

Discuss and review directly on pages.

Examples:

  • Add a comment “We should update this section before publishing” to the page “Landing Page Draft”.

  • Retrieve the first 20 comments on the page “Landing Page Draft”.

  • List all comments on “Landing Page Draft”, limit 50 per page.

Last updated