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 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")

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