Notion

Available Tools

notion_search(query?, filter_type?, page_size?): Search across all accessible pages and databases.

• query (string, optional): Search text. Empty string returns all accessible pages.

• filter_type (string, optional): "page" or "database" . Use "database" to list databases.

• page_size (integer, optional, default: 10, max: 100)

notion_fetch(page_id, include_block_ids?): Fetch a page's full content as readable markdown (metadata + all blocks in one call).

• page_id (string, required): Page or database entry ID.

• include_block_ids (boolean, optional, default: false): If true, appends each block's ID as <!-- id:... --> . Use this when you need to update a specific block with notion_update_block .

• Returns: title, URL, last-edited time, and full body as markdown.

notion_create_page(parent_type, parent_id, title, properties_json?, content_markdown?): Create a new page.

• parent_type (string, required): "database" , "page" , or "workspace" (workspace root)

• parent_id (string, required): Parent UUID — ignored when parent_type="workspace"

• title (string, required): Page title

• properties_json (string, optional): Database properties as a JSON string — e.g., '{"Status": {"select": {"name": "In Progress"}}}'

• content_markdown (string, optional): Initial body content as markdown (see Markdown Support below)

notion_update_page(page_id, properties_json, archived?): Update page properties (metadata/database fields only, not content blocks).

notion_update_block(block_id, content_markdown): Replace the content of a specific existing block.

• block_id (string, required): Block ID — obtain via notion_fetch(include_block_ids=True)

• content_markdown (string, required): New content as a single markdown line (only the first block is used)

• page_id (string, required)

• properties_json (string, required): Properties as a JSON string

• archived (boolean, optional): true to archive, false to unarchive

notion_append_blocks(page_id, content_markdown): Append new content blocks to the end of an existing page.

• page_id (string, required)

• content_markdown (string, required): Markdown content to append (see Markdown Support below)

Markdown Support

Both notion_create_page (content_markdown) and notion_append_blocks support:

Syntax Block type

Title

/ ## Heading / ### Sub

heading_1 / heading_2 / heading_3

• item or * item

bulleted_list_item

1. item

numbered_list_item

• task

to_do (unchecked)

• task

to_do (checked)

python\ncode\n

code block with language

text

quote

divider

bold

bold inline

italic

italic inline

code

inline code

Common Workflows

Find and read a page:

1. notion_search(query="page name") → get page id
2. notion_fetch(page_id) → read full content

Create a new page with content:

notion_create_page( parent_type="page", parent_id="<parent-page-id>", title="My Page", content_markdown="## Overview\n\nContent here..." )

Add content to existing page:

notion_append_blocks( page_id="<page-id>", content_markdown="## New Section\n\n- Point 1\n- Point 2" )

Edit a specific block:

1. notion_fetch(page_id, include_block_ids=True) → ## Old Heading <!-- id:abc-123 -->
2. notion_update_block(block_id="abc-123", content_markdown="## New Heading")

List databases:

notion_search(filter_type="database")

Use-Case Guides

For specific workflow patterns, load the reference files:

• knowledge-capture.md — Save conversation insights, decisions, and how-to guides to Notion wikis and databases

• meeting-intelligence.md — Prepare meeting materials by gathering Notion context and creating pre-reads and agendas

• research-documentation.md — Research across Notion pages, synthesize findings, and write structured reports

• spec-to-implementation.md — Turn spec pages into implementation plans, tasks, and progress tracking

Load a reference with: skill_dispatcher("notion", reference="knowledge-capture.md")