v0.14.0

v0.14.0 - Table of Contents Support

Added

• Table of Contents Support: [TOC] syntax now creates table_of_contents block
  • Case-insensitive: [TOC], [toc], [Toc] all work
  • Completes bidirectional conversion (Notion ↔ Markdown)

Full Changelog: v0.13.0...v0.14.0

v0.13.0

Added

• Batch Block Deletion Tools: New tools for efficient block deletion
  • delete-blocks-batch: Delete multiple blocks by IDs (max 100). Use get-block-children with format="simple" to get IDs first.
  • clear-page-content: Delete all content from a page. Preserves child_database and child_page by default. Use preserve_types: [] to delete everything.
• Block ID Retrieval Format: get-block-children now supports format="simple" for lightweight ID + type + content output
  • Ideal for deletion target selection (much lighter than json format)
  • Returns: { blocks: [{ id, type, content }], has_more, next_cursor }

Full Changelog: https://github.com/atikk-co-jp/notion-mcp-server/blob/main/CHANGELOG.md

v0.12.0

What's Changed

New Features

• Child Page Creation: create-page and create-page-simple now support creating child pages under an existing page
  • New parent.page_id parameter to specify parent page
  • Use either parent.page_id (for child pages) or parent.data_source_id (for database entries)
  • For page parent, title property name defaults to title; for data source parent, auto-detects from schema

Documentation

• Updated README with child page creation examples (English/Japanese)

Full Changelog: v0.11.0...v0.12.0

v0.11.0

What's New

Added

• Bidirectional Extended Markdown Support: Full support for extended markdown syntax in both directions
  • Markdown → Notion: create-page-simple, append-blocks-simple now support extended syntax
  • Notion → Markdown: retrieve-page, get-block-children now output extended syntax
• Extended Markdown Syntax: New block types and inline formatting
  • Toggle: <details><summary>title</summary>content</details>
  • Callout: > [!NOTE], > [!WARNING], > [!TIP], > [!IMPORTANT], > [!CAUTION]
  • Equation: $$E = mc^2$$ (block), $inline$ (inline)
  • Underline: <u>text</u> or ++text++
  • Color: {color:red}text{/color}, {bg:yellow}text{/bg}
  • Bookmark: [bookmark](url) or [bookmark:caption](url)
  • Columns: :::columns / :::column / :::
  • Media embeds: @[embed](url), @[video](url), @[audio](url), @[file](url), @[pdf](url)

Improved

• Test Coverage: Added comprehensive tests for all extended markdown conversions (411 tests total)
• Documentation: Added Extended Markdown section to README with syntax examples

Full Changelog: v0.10.2...v0.11.0

v0.10.2

Changed

• README Quick Start Optimization: Reorganized README for users who want to get started quickly
  • Removed "Installation" section (unnecessary for MCP users who use npx)
  • Renamed "Usage" section to "Quick Start"
  • Integrated token acquisition steps into Quick Start (Step 1)
  • Integrated configuration steps into Quick Start (Step 2)
  • Changed token placeholder to ntn_xxxxxxxxxxxx for clarity

v0.10.1

What's Changed

Added

• README "Why this repository?" Section: Added explanation of why this repository was created
  • Comparison table with Official Notion MCP and open-source version
  • Plan restrictions explained (Notion AI, Enterprise+AI)
  • Token efficiency comparison

Changed

• .gitignore: Added tmp/ to ignore temporary files

Full Changelog: v0.10.0...v0.10.1

v0.10.0

v0.10.0

Added

• Page Content Replacement Tools: New tools for easier page content management
  • replace-page-content: Replace all content of a page with Markdown (preserves child_database/child_page)
  • find-and-replace-in-page: Find and replace text in a page with regex support
• Dry Run Mode: Preview which blocks will be deleted before executing
  • replace-page-content: Added dry_run parameter to preview deletions without making changes
  • Shows block counts grouped by type (e.g., will_delete_by_type: {paragraph: 5, bookmark: 1})
• Unit Tests: Added tests for find-and-replace utility functions (textMatches, replaceText)

Improved

• Tool Descriptions: Enhanced descriptions to help LLMs choose the right tool
  • Added warning about non-Markdown blocks being deleted in replace-page-content
  • Added Markdown syntax examples to replace-page-content
  • Added regex examples to find-and-replace-in-page
  • Added cross-references between related tools

v0.9.1

Fixed

• Minimal Response Implementation: Fixed missing minimal response for simple write tools
  • create-page-simple: Now correctly returns {id, url} (was returning full response)
  • update-block-simple: Now correctly returns {id} (was returning full response)

v0.9.0

What's Changed

Added

• fields Parameter: Filter which properties are returned in results
  • query-data-source: Added fields parameter to limit returned properties
  • search: Added fields parameter to limit returned properties (simple format only)
• search format Parameter: Added format parameter (simple/json) to search tool
  • simple (default): Returns compact results with reduced token usage
  • json: Returns full Notion API response

Changed

• Minimal Response for Write Operations: All write tools now return only essential data (~90% token reduction)
  • create-page / create-page-simple: Returns {id, url} only
  • update-page: Returns {id, url} only
  • move-page: Returns {id, url} only
  • archive-page: Returns {id} only
  • create-database: Returns {id, url} only
  • update-database: Returns {id, url} only
  • archive-database: Returns {id} only
  • update-data-source: Returns {id} only
  • append-block-children / append-blocks-simple: Returns {block_ids} only
  • update-block / update-block-simple: Returns {id} only
  • delete-block: Returns {id} only
  • create-comment / create-comment-simple: Returns {id} only
• Default Format: Unified default format to simple for all read tools
  • retrieve-page: Default changed to simple
  • retrieve-database: Default changed to simple
  • retrieve-data-source: Default changed to simple
  • query-data-source: Default changed to simple
  • search: Default is simple
• retrieve-data-source Simple Format: Options now return names only (not full objects with color)

Full Changelog: https://github.com/atikk-co-jp/notion-mcp-server/blob/main/CHANGELOG.md

v0.8.1

Fixed

• Documentation: Fixed incorrect package name in MCP configuration examples
  • Changed atikk-notion-mcp-server to @atikk-co-jp/notion-mcp-server

---

Full Changelog: v0.8.0...v0.8.1