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) |
- [x] 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 contentCreate 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")
UI Guidance (from tools-config)
Notion Tool Usage:
- notion_search: Search pages and databases. Use filter_type='database' to list databases.
- notion_fetch: Read a page's full content as markdown (metadata + all blocks in one call).
- notion_create_page: Create a new page with markdown content.
- notion_update_page: Update page properties (not content — use notion_append_blocks for content).
- notion_append_blocks: Add markdown content to an existing page.
Typical workflows:
- Find and read: notion_search → notion_fetch
- Create from scratch: notion_create_page with content_markdown
- Update content: notion_append_blocks with markdown
Markdown support in content_markdown/notion_append_blocks:
- Headings: # H1 / ## H2 / ### H3
- Lists: - bullet / 1. numbered
- To-do: - [] unchecked / - [x] checked
- Code:
python... - Quote: > text
- Divider: ---
- Inline: bold, *italic*,
code