notion

name	notion
description	Notion API for creating and managing pages and databases
triggers	["notion","note","write this down","save to notion","add to notion"]
requires	NOTION_API_KEY in .env

Notion

What it does

Creates, reads, and updates Notion pages and databases via the Notion API.

Use when

• User says "write this down" or "save to Notion"
• User says "add [content] to Notion"
• User says "search my notes for [query]"

Security

• NOTION_API_KEY is loaded from .env only — never hardcoded, never logged
• Never expose the API key in any spoken response or log
• Only interact with pages/databases explicitly shared with the integration
• Rate limit: respect Notion's 3 requests/second

Setup

Requires NOTION_API_KEY in .env (starts with ntn_ or secret_). Target pages/databases must be shared with the Notion integration.

How to create a quick note

1. notion_search(query="<target page/database name>") — find where to save
2. notion_create_page(title="<title>", content="<content>", database_id="<id>") — create the page
3. Confirm to user: "Saved to Notion"

How to add to existing page

1. notion_search(query="<page name>") — find the page
2. notion_append(page_id="<id>", content="<text>") — append content

Primitives used

• notion_search(query) — search pages and databases by title
• notion_create_page(title, content, database_id) — create a new page
• notion_append(page_id, content) — append text blocks to existing page
• notion_query_db(database_id, filter_property, filter_value) — query a database