Skip to main content

​
Overview

The Notion server provides comprehensive integration with Notion workspaces, enabling AI assistants to manage databases, pages, blocks, and comments for enhanced productivity and knowledge management.

​
Getting Started

1

Connect to Notion

Add the Notion server to your Civic environment through the server directory.
2

Test Connection

Start with a simple command like search for pages or list users to verify the connection works properly.

​
What You Can Do

Page Management

Create, update, retrieve, and manage Notion pages with full content control

Database Operations

Query databases, create new databases, and manage database properties

Content Creation

Add blocks, append content, and structure information with rich text formatting

Team Collaboration

Manage comments, retrieve user information, and facilitate workspace collaboration

​
Available Tools (21)

​
User Management

API-get-user — Retrieve a specific user by user ID
API-get-users — List all users in the workspace with pagination support
API-get-self — Retrieve your token’s bot user information

​
Database Operations

API-post-database-query — Query a database with filters, sorts, and pagination
API-create-a-database — Create a new database with specified properties
API-update-a-database — Update database title, description, and properties
API-retrieve-a-database — Retrieve database information and schema

​
Page Management

API-post-page — Create a new page with properties, content, and cover
API-patch-page — Update page properties, icon, cover, and archive status
API-retrieve-a-page — Retrieve page content and properties
API-retrieve-a-page-property — Retrieve a specific page property item

​
Block Management

API-get-block-children — Retrieve all child blocks from a parent block
API-patch-block-children — Append new blocks as children to existing blocks
API-retrieve-a-block — Retrieve a specific block by block ID
API-update-a-block — Update block content and properties
API-delete-a-block — Delete a block from the page

​
Search & Comments

API-post-search — Search pages and databases by title with filters and sorting
API-retrieve-a-comment — Retrieve comments on a specific block or page
API-create-a-comment — Create a new comment on a page

​
Use Cases

​
Knowledge Management

  • Content Creation: “Create a new project page with task database and initial content”
  • Information Retrieval: “Search for all pages related to ‘quarterly planning’”
  • Documentation: “Update the API documentation page with new endpoints”

​
Database Operations

  • Data Analysis: “Query the customer database for all high-priority leads”
  • Project Tracking: “Create a new project database with status and assignee properties”
  • Reporting: “Retrieve all completed tasks from the sprint database”

​
Team Collaboration

  • Feedback Collection: “Add a comment to the design review page”
  • User Management: “List all workspace members and their roles”
  • Content Review: “Get all comments on the proposal document”

​
Content Structure

  • Page Organization: “Add bullet points and paragraphs to the meeting notes page”
  • Database Setup: “Create a CRM database with contact properties and relationships”
  • Information Architecture: “Retrieve all child pages from the company handbook”
The Notion server requires appropriate workspace permissions and OAuth2 authentication to access and modify content in your Notion workspace.

​
Guardrails

In addition to the 14 universal guardrails, this server has 19 server-specific guardrails across 11 operations.
Rich guardrail set — combining allowlist controls (approved pages/databases), sensitive content filters on reads, protected content on writes, and batch size limits.
GuardrailOperationTimingDescription
Approved Comment Pagescreate-a-commentRequestRestricts comments to approved pages only
Protected Blocksdelete-a-blockRequestPrevents deletion of protected blocks
Retrieve Block Children Sensitive Content Filterget-block-childrenResponseRedacts sensitive content from block children
Approved Move Database Targetsmove-pageRequestRestricts page moves to approved databases
Approved Move Targetsmove-pageRequestRestricts page moves to approved parent pages
Protected Pages (Move)move-pageRequestPrevents moving protected pages
Protected Pages (Update)patch-pageRequestPrevents updates to protected pages
Approved Databasespost-database-queryRequestOnly allows querying approved databases
Approved Database Parentspost-pageRequestRestricts page creation to approved databases
Approved Page Parentspost-pageRequestRestricts page creation to approved parent pages
Search Sensitive Content Filterpost-searchResponseRedacts sensitive content from search results
Search Term Filterpost-searchRequestPrevents searching for sensitive terms
Approved Data Sourcesquery-data-sourceRequestOnly allows querying approved data sources
Page Property Filterquery-data-sourceResponseFilters results by property values
Query Sensitive Content Filterquery-data-sourceResponseRedacts sensitive content from query results
Retrieve Block Sensitive Content Filterretrieve-a-blockResponseRedacts sensitive content from block retrieval
Approved Pages (Retrieve)retrieve-a-pageRequestRestricts retrieval to approved pages only
Protected Data Sourcesupdate-a-data-sourceRequestPrevents updates to protected databases
Batch Operation Size Limit(all operations)RequestLimits number of operations in batch requests
Configure guardrails via the Civic UI or ask the Configurator Agent: “Add guardrails to my Notion server.”