Notion
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
- 1Connect to Notion
Add the Notion server to your Civic environment through the server directory.
- 2Test Connection
Start with a simple command like
search for pagesorlist usersto verify the connection works properly.
What You Can Do
Create, update, retrieve, and manage Notion pages with full content control
Query databases, create new databases, and manage database properties
Add blocks, append content, and structure information with rich text formatting
Manage comments, retrieve user information, and facilitate workspace collaboration
Available Tools (21)
User Management
API-get-user
API-get-user — Retrieve a specific user by user ID
API-get-users
API-get-users — List all users in the workspace with pagination support
API-get-self
API-get-self — Retrieve your token's bot user information
Database Operations
API-post-database-query
API-post-database-query — Query a database with filters, sorts, and pagination
API-create-a-database
API-create-a-database — Create a new database with specified properties
API-update-a-database
API-update-a-database — Update database title, description, and properties
API-retrieve-a-database
API-retrieve-a-database — Retrieve database information and schema
Page Management
API-post-page
API-post-page — Create a new page with properties, content, and cover
API-patch-page
API-patch-page — Update page properties, icon, cover, and archive status
API-retrieve-a-page
API-retrieve-a-page — Retrieve page content and properties
API-retrieve-a-page-property
API-retrieve-a-page-property — Retrieve a specific page property item
Block Management
API-get-block-children
API-get-block-children — Retrieve all child blocks from a parent block
API-patch-block-children
API-patch-block-children — Append new blocks as children to existing blocks
API-retrieve-a-block
API-retrieve-a-block — Retrieve a specific block by block ID
API-update-a-block
API-update-a-block — Update block content and properties
API-delete-a-block
API-delete-a-block — Delete a block from the page
Search & Comments
API-post-search
API-post-search — Search pages and databases by title with filters and sorting
API-retrieve-a-comment
API-retrieve-a-comment — Retrieve comments on a specific block or page
API-create-a-comment
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.
| Guardrail | Operation | Timing | Description |
|---|---|---|---|
| Approved Comment Pages | create-a-comment | Request | Restricts comments to approved pages only |
| Protected Blocks | delete-a-block | Request | Prevents deletion of protected blocks |
| Retrieve Block Children Sensitive Content Filter | get-block-children | Response | Redacts sensitive content from block children |
| Approved Move Database Targets | move-page | Request | Restricts page moves to approved databases |
| Approved Move Targets | move-page | Request | Restricts page moves to approved parent pages |
| Protected Pages (Move) | move-page | Request | Prevents moving protected pages |
| Protected Pages (Update) | patch-page | Request | Prevents updates to protected pages |
| Approved Databases | post-database-query | Request | Only allows querying approved databases |
| Approved Database Parents | post-page | Request | Restricts page creation to approved databases |
| Approved Page Parents | post-page | Request | Restricts page creation to approved parent pages |
| Search Sensitive Content Filter | post-search | Response | Redacts sensitive content from search results |
| Search Term Filter | post-search | Request | Prevents searching for sensitive terms |
| Approved Data Sources | query-data-source | Request | Only allows querying approved data sources |
| Page Property Filter | query-data-source | Response | Filters results by property values |
| Query Sensitive Content Filter | query-data-source | Response | Redacts sensitive content from query results |
| Retrieve Block Sensitive Content Filter | retrieve-a-block | Response | Redacts sensitive content from block retrieval |
| Approved Pages (Retrieve) | retrieve-a-page | Request | Restricts retrieval to approved pages only |
| Protected Data Sources | update-a-data-source | Request | Prevents updates to protected databases |
| Batch Operation Size Limit | (all operations) | Request | Limits number of operations in batch requests |
Configure guardrails via the Civic UI or ask the Configurator Agent: "Add guardrails to my Notion server."