Notion

The Notion integration enables agents to create and manage pages, query databases, and search across a workspace.

Setup

skillett connect notion

Skillett handles all authentication automatically when you connect.

Endpoints

Endpoint	Method	Description
search	POST	Search pages and databases
create_page	POST	Create a new page
get_page	GET	Get page properties
update_page	PATCH	Update page properties
archive_page	PATCH	Archive (soft delete) a page
query_database	POST	Query a database with filters/sorts
get_database	GET	Get database schema
create_database	POST	Create a new database
list_block_children	GET	Get page content (blocks)
append_block_children	PATCH	Add content to a page
get_block	GET	Get a specific block
delete_block	DELETE	Delete a block

Example usage

# Search for pages
skillett run notion search --query "meeting notes"

# Query a database
skillett run notion query_database --database_id "abc123" --filter '{"property":"Status","select":{"equals":"In Progress"}}'

# Create a page
skillett run notion create_page --parent '{"database_id":"abc123"}' --properties '{"Name":{"title":[{"text":{"content":"New task"}}]}}'

# Get page content
skillett run notion list_block_children --block_id "page_abc123"

Common patterns

• IDs: Notion uses UUIDs for pages, databases, and blocks
• Rich text: Text content uses Notion’s rich text format (array of text objects)
• Properties: Database properties are typed (title, rich_text, number, select, multi_select, date, etc.)
• Filters: Database queries use a structured filter format