@atikk-co-jp/notion-mcp-server 0.9.0 → 0.10.0

package/README.ja.md

@@ -4,9 +4,7 @@
 
 Notion API用のMCP（Model Context Protocol）サーバー。AIアシスタントがNotionのページ、データベース、ブロックを操作できるようにします。
 
-> ⚠️ **注意**: これは初期リリースです。APIは変更される可能性があります。
-
-> **APIバージョン**: 2025-09-03（最新）
+**APIバージョン**: 2025-09-03（最新）
 
 ## 特徴
 
@@ -52,6 +50,9 @@ Notion API用のMCP（Model Context Protocol）サーバー。AIアシスタン
 | | [Retrieve block children](https://developers.notion.com/reference/get-block-children) | `get-block-children` | JSON | **markdown**/json |
 | | [Append block children](https://developers.notion.com/reference/patch-block-children) | `append-block-children` 📤 | JSON | `{block_ids}` |
 | | | `append-blocks-simple` ⭐📤 | Markdown | `{block_ids}` |
+| **ページコンテンツ** | | | | |
+| | - | `replace-page-content` ⭐📤 | Markdown | `{deleted_count, created_count}` |
+| | - | `find-and-replace-in-page` ⭐📤 | Markdown | `{updated_count, updated_block_ids}` |
 | **コメント** | | | | |
 | | [Create comment](https://developers.notion.com/reference/create-a-comment) | `create-comment` 📤 | JSON | `{id}` |
 | | | `create-comment-simple` ⭐📤 | Markdown | `{id}` |
@@ -418,6 +419,71 @@ Markdownを使ってブロックを追加します。`append-block-children`と
 }
 ```
 
+### replace-page-content ⭐
+
+ページの全コンテンツをMarkdownで置換します。`child_database`と`child_page`ブロックは自動的に保護されます（削除されません）。
+
+**パラメータ:**
+- `page_id` (必須): 更新するページのID
+- `content` (必須): 新しいコンテンツ（Markdown形式）
+- `dry_run` (任意): 削除されるブロックをプレビュー（実際には変更しない）（デフォルト: false）
+
+**⚠️ 注意:** Markdownで表現できないブロック（bookmark, callout, equation, table_of_contents, synced_block等）は**削除されます**。実行前に `dry_run: true` でプレビューを確認してください。
+
+**サポートするMarkdown記法:**
+見出し(#)、リスト(- または 1.)、チェックボックス(- [ ])、コードブロック(```)、引用(>)、テーブル(| |)、画像(![]())、太字(**)、イタリック(*)、リンク([]())
+
+```json
+{
+  "page_id": "ページのUUID",
+  "content": "# 新しいタイトル\n\nこれは完全に新しいコンテンツです。\n\n## セクション1\n\n- 項目1\n- 項目2"
+}
+```
+
+**削除プレビュー (dry run):**
+```json
+{
+  "page_id": "ページのUUID",
+  "content": "# 新しいコンテンツ",
+  "dry_run": true
+}
+```
+
+**使い分け:**
+- ページ全体を書き換えたい場合 → `replace-page-content`
+- 特定のテキストだけ置換したい場合 → `find-and-replace-in-page`
+- 単一ブロックを更新したい（block_idがわかる）場合 → `update-block-simple`
+
+### find-and-replace-in-page ⭐
+
+ページ内のテキストを検索して置換します。正規表現にも対応。
+
+**パラメータ:**
+- `page_id` (必須): 対象ページのID
+- `find` (必須): 検索文字列（`use_regex: true`の場合は正規表現パターン）
+- `replace` (必須): 置換テキスト（Markdown対応: **太字**, *イタリック*, [リンク](url)など）
+- `use_regex` (任意): trueの場合、`find`を正規表現として解釈（デフォルト: false）
+
+```json
+{
+  "page_id": "ページのUUID",
+  "find": "古いテキスト",
+  "replace": "**新しいテキスト**"
+}
+```
+
+**正規表現の例:**
+```json
+{
+  "page_id": "ページのUUID",
+  "find": "item\\d+",
+  "replace": "アイテム",
+  "use_regex": true
+}
+```
+
+**対象ブロックタイプ:** paragraph, heading_1/2/3, bulleted_list_item, numbered_list_item, to_do, quote, callout, toggle
+
 ## 開発
 
 ```bash

package/README.md

@@ -4,9 +4,7 @@ English | [日本語](./README.ja.md)
 
 MCP (Model Context Protocol) server for Notion API. Enables AI assistants to interact with Notion pages, databases, and blocks.
 
-> ⚠️ **Note**: This is an early release. API may change.
-
-> **API Version**: 2025-09-03 (latest)
+**API Version**: 2025-09-03 (latest)
 
 ## Features
 
@@ -52,6 +50,8 @@ MCP (Model Context Protocol) server for Notion API. Enables AI assistants to int
 | | [Retrieve block children](https://developers.notion.com/reference/get-block-children) | `get-block-children` | JSON | **markdown**/json |
 | | [Append block children](https://developers.notion.com/reference/patch-block-children) | `append-block-children` 📤 | JSON | `{block_ids}` |
 | | | `append-blocks-simple` ⭐📤 | Markdown | `{block_ids}` |
+| | | `replace-page-content` ⭐📤 | Markdown | `{deleted_count, created_count}` |
+| | | `find-and-replace-in-page` ⭐📤 | Markdown | `{updated_count, updated_block_ids}` |
 | **Comments** | | | | |
 | | [Create comment](https://developers.notion.com/reference/create-a-comment) | `create-comment` 📤 | JSON | `{id}` |
 | | | `create-comment-simple` ⭐📤 | Markdown | `{id}` |
@@ -407,6 +407,67 @@ Same Markdown support as `create-page-simple`.
 | append-block-children (blocks) | ~201 | - |
 | append-blocks-simple (markdown) | ~42 | **79%** |
 
+### replace-page-content ⭐
+
+Replace all content of a page with new Markdown content. Automatically preserves `child_database` and `child_page` blocks.
+
+**Parameters:**
+- `page_id` (required): The page ID to update
+- `content` (required): New content in Markdown
+- `dry_run` (optional): Preview which blocks will be deleted without making changes (default: false)
+
+**⚠️ Warning:** Blocks not supported by Markdown (bookmark, callout, equation, table_of_contents, synced_block, etc.) will be **DELETED**. Use `dry_run: true` to preview before executing.
+
+**Use when:** You want to completely rewrite page content without finding individual block IDs.
+
+Same Markdown support as `create-page-simple`.
+
+```json
+{
+  "page_id": "page-uuid-here",
+  "content": "# New Page Title\n\nThis is the new content.\n\n## Section 1\n\n- Item 1\n- Item 2"
+}
+```
+
+**Preview deletions (dry run):**
+```json
+{
+  "page_id": "page-uuid-here",
+  "content": "# New content",
+  "dry_run": true
+}
+```
+
+### find-and-replace-in-page ⭐
+
+Find text in a page and replace it with new content. Supports regex patterns for advanced matching.
+
+**Parameters:**
+- `page_id` (required): The page ID to search in
+- `find` (required): Text to find (string or regex pattern)
+- `replace` (required): Replacement text (supports Markdown: `**bold**`, `*italic*`, etc.)
+- `use_regex` (optional): If true, treat `find` as a regex pattern (default: false)
+
+**Use when:** You want to update specific text without rewriting the entire page.
+
+```json
+{
+  "page_id": "page-uuid-here",
+  "find": "old text",
+  "replace": "**new text**"
+}
+```
+
+**With regex:**
+```json
+{
+  "page_id": "page-uuid-here",
+  "find": "item\\d+",
+  "replace": "updated item",
+  "use_regex": true
+}
+```
+
 ### create-comment
 
 Add a comment to a page.

package/dist/src/notion-client.d.ts

@@ -1,7 +1,6 @@
 import { Client } from '@notionhq/client';
-export type { AppendBlockChildrenParameters, AppendBlockChildrenResponse, BlockObjectRequest, BlockObjectResponse, BotUserObjectResponse, CommentObjectResponse, CreateCommentParameters, CreateCommentResponse, CreateDatabaseParameters, CreateDatabaseResponse, CreateDataSourceParameters, CreateDataSourceResponse, CreatePageParameters, CreatePageResponse, DatabaseObjectResponse, DataSourceObjectResponse, DeleteBlockParameters, DeleteBlockResponse, EquationRichTextItemResponse, GetBlockParameters, GetBlockResponse, GetDatabaseParameters, GetDatabaseResponse, GetDataSourceParameters, GetDataSourceResponse, GetPageParameters, GetPagePropertyParameters, GetPagePropertyResponse, GetPageResponse, GetSelfParameters, GetSelfResponse, GetUserParameters, GetUserResponse, ListBlockChildrenParameters, ListBlockChildrenResponse, ListCommentsParameters, ListCommentsResponse, ListUsersParameters, ListUsersResponse, MentionRichTextItemResponse, MovePageParameters, MovePageResponse, PageObjectResponse, PartialBlockObjectResponse, PartialCommentObjectResponse, PartialDatabaseObjectResponse, PartialDataSourceObjectResponse, PartialPageObjectResponse, PartialUserObjectResponse, PersonUserObjectResponse, PropertyItemListResponse, PropertyItemObjectResponse, QueryDataSourceParameters, QueryDataSourceResponse, RichTextItemResponse, SearchParameters, SearchResponse, TextRichTextItemResponse, UpdateBlockParameters, UpdateBlockResponse, UpdateDatabaseParameters, UpdateDatabaseResponse, UpdateDataSourceParameters, UpdateDataSourceResponse, UpdatePageParameters, UpdatePageResponse, UserObjectResponse, } from '@notionhq/client';
+export type { AppendBlockChildrenParameters, AppendBlockChildrenResponse, BlockObjectRequest, BlockObjectResponse, BotUserObjectResponse, CommentObjectResponse, CreateCommentParameters, CreateCommentResponse, CreateDatabaseParameters, CreateDatabaseResponse, CreateDataSourceParameters, CreateDataSourceResponse, CreatePageParameters, CreatePageResponse, DatabaseObjectResponse, DataSourceObjectResponse, DeleteBlockParameters, DeleteBlockResponse, EquationRichTextItemResponse, GetBlockParameters, GetBlockResponse, GetDatabaseParameters, GetDatabaseResponse, GetDataSourceParameters, GetDataSourceResponse, GetPageParameters, GetPagePropertyParameters, GetPagePropertyResponse, GetPageResponse, GetSelfParameters, GetSelfResponse, GetUserParameters, GetUserResponse, ListBlockChildrenParameters, ListBlockChildrenResponse, ListCommentsParameters, ListCommentsResponse, ListUsersParameters, ListUsersResponse, MentionRichTextItemResponse, MovePageParameters, MovePageResponse, NotionClientError, PageObjectResponse, PartialBlockObjectResponse, PartialCommentObjectResponse, PartialDatabaseObjectResponse, PartialDataSourceObjectResponse, PartialPageObjectResponse, PartialUserObjectResponse, PersonUserObjectResponse, PropertyItemListResponse, PropertyItemObjectResponse, QueryDataSourceParameters, QueryDataSourceResponse, RichTextItemResponse, SearchParameters, SearchResponse, TextRichTextItemResponse, UpdateBlockParameters, UpdateBlockResponse, UpdateDatabaseParameters, UpdateDatabaseResponse, UpdateDataSourceParameters, UpdateDataSourceResponse, UpdatePageParameters, UpdatePageResponse, UserObjectResponse, } from '@notionhq/client';
 export { APIResponseError, Client as NotionClient, collectPaginatedAPI, isFullBlock, isFullComment, isFullDatabase, isFullDataSource, isFullPage, isFullUser, isNotionClientError, iteratePaginatedAPI, } from '@notionhq/client';
-export type { NotionClientError } from '@notionhq/client';
 export interface NotionClientOptions {
     token: string;
 }

package/dist/src/notion-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notion-client.d.ts","sourceRoot":"","sources":["../../src/notion-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAIzC,YAAY,EACV,6BAA6B,EAC7B,2BAA2B,EAC3B,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EAErB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAElB,sBAAsB,EAEtB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,4BAA4B,EAC5B,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,EACjB,yBAAyB,EACzB,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,2BAA2B,EAC3B,yBAAyB,EACzB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,2BAA2B,EAC3B,kBAAkB,EAClB,gBAAgB,EAEhB,kBAAkB,EAClB,0BAA0B,EAC1B,4BAA4B,EAC5B,6BAA6B,EAC7B,+BAA+B,EAC/B,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,wBAAwB,EAExB,0BAA0B,EAC1B,yBAAyB,EACzB,uBAAuB,EAEvB,oBAAoB,EAEpB,gBAAgB,EAChB,cAAc,EACd,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAElB,kBAAkB,GACnB,MAAM,kBAAkB,CAAA;AAIzB,OAAO,EACL,gBAAgB,EAChB,MAAM,IAAI,YAAY,EACtB,mBAAmB,EACnB,WAAW,EACX,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,kBAAkB,CAAA;AAGzB,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEzD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAA;CACd;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAS3C"}
+{"version":3,"file":"notion-client.d.ts","sourceRoot":"","sources":["../../src/notion-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAKzC,YAAY,EACV,6BAA6B,EAC7B,2BAA2B,EAC3B,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EAErB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAElB,sBAAsB,EAEtB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,4BAA4B,EAC5B,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,EACjB,yBAAyB,EACzB,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,2BAA2B,EAC3B,yBAAyB,EACzB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,2BAA2B,EAC3B,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EAEjB,kBAAkB,EAClB,0BAA0B,EAC1B,4BAA4B,EAC5B,6BAA6B,EAC7B,+BAA+B,EAC/B,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,wBAAwB,EAExB,0BAA0B,EAC1B,yBAAyB,EACzB,uBAAuB,EAEvB,oBAAoB,EAEpB,gBAAgB,EAChB,cAAc,EACd,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAElB,kBAAkB,GACnB,MAAM,kBAAkB,CAAA;AAIzB,OAAO,EACL,gBAAgB,EAChB,MAAM,IAAI,YAAY,EACtB,mBAAmB,EACnB,WAAW,EACX,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,kBAAkB,CAAA;AAEzB,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAA;CACd;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAS3C"}

package/dist/src/tools/__tests__/find-and-replace.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=find-and-replace.test.d.ts.map

package/dist/src/tools/__tests__/find-and-replace.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-and-replace.test.d.ts","sourceRoot":"","sources":["../../../../src/tools/__tests__/find-and-replace.test.ts"],"names":[],"mappings":""}

package/dist/src/tools/__tests__/find-and-replace.test.js

@@ -0,0 +1,92 @@
+import { describe, expect, it } from 'vitest';
+import { replaceText, textMatches } from '../find-and-replace-in-page.js';
+describe('find-and-replace-in-page utilities', () => {
+    describe('textMatches', () => {
+        describe('string matching (useRegex: false)', () => {
+            it('should match exact substring', () => {
+                expect(textMatches('Hello World', 'World', false)).toBe(true);
+            });
+            it('should match partial substring', () => {
+                expect(textMatches('Hello World', 'llo', false)).toBe(true);
+            });
+            it('should return false when no match', () => {
+                expect(textMatches('Hello World', 'Foo', false)).toBe(false);
+            });
+            it('should be case sensitive', () => {
+                expect(textMatches('Hello World', 'world', false)).toBe(false);
+            });
+            it('should handle empty search string', () => {
+                expect(textMatches('Hello World', '', false)).toBe(true);
+            });
+            it('should handle empty text', () => {
+                expect(textMatches('', 'Hello', false)).toBe(false);
+            });
+            it('should handle Japanese text', () => {
+                expect(textMatches('こんにちは世界', '世界', false)).toBe(true);
+            });
+        });
+        describe('regex matching (useRegex: true)', () => {
+            it('should match with simple regex', () => {
+                expect(textMatches('Hello World', 'World', true)).toBe(true);
+            });
+            it('should match with regex pattern', () => {
+                expect(textMatches('Hello123World', '\\d+', true)).toBe(true);
+            });
+            it('should match with character class', () => {
+                expect(textMatches('item1', 'item\\d', true)).toBe(true);
+            });
+            it('should return false when regex does not match', () => {
+                expect(textMatches('Hello World', '^World', true)).toBe(false);
+            });
+            it('should handle invalid regex gracefully (fallback to string match)', () => {
+                expect(textMatches('Hello [World', '[World', true)).toBe(true);
+            });
+            it('should handle regex special characters', () => {
+                expect(textMatches('Hello.World', '\\.', true)).toBe(true);
+            });
+        });
+    });
+    describe('replaceText', () => {
+        describe('string replacement (useRegex: false)', () => {
+            it('should replace exact match', () => {
+                expect(replaceText('Hello World', 'World', 'Universe', false)).toBe('Hello Universe');
+            });
+            it('should replace all occurrences', () => {
+                expect(replaceText('foo bar foo baz foo', 'foo', 'qux', false)).toBe('qux bar qux baz qux');
+            });
+            it('should handle no match', () => {
+                expect(replaceText('Hello World', 'Foo', 'Bar', false)).toBe('Hello World');
+            });
+            it('should handle empty replacement', () => {
+                expect(replaceText('Hello World', 'World', '', false)).toBe('Hello ');
+            });
+            it('should handle Japanese text', () => {
+                expect(replaceText('こんにちは世界', '世界', 'ワールド', false)).toBe('こんにちはワールド');
+            });
+            it('should handle markdown in replacement', () => {
+                expect(replaceText('Hello World', 'World', '**Universe**', false)).toBe('Hello **Universe**');
+            });
+        });
+        describe('regex replacement (useRegex: true)', () => {
+            it('should replace with simple regex', () => {
+                expect(replaceText('Hello World', 'World', 'Universe', true)).toBe('Hello Universe');
+            });
+            it('should replace with pattern', () => {
+                expect(replaceText('item1 item2 item3', 'item\\d', 'x', true)).toBe('x x x');
+            });
+            it('should handle capture groups', () => {
+                expect(replaceText('Hello World', '(World)', '[$1]', true)).toBe('Hello [World]');
+            });
+            it('should handle invalid regex gracefully (fallback to string replace)', () => {
+                // Unclosed bracket is invalid regex, should fallback to string replacement
+                expect(replaceText('Hello [incomplete [incomplete', '[incomplete', 'X', true)).toBe('Hello X X');
+            });
+            it('should handle global replacement', () => {
+                expect(replaceText('aaa', 'a', 'b', true)).toBe('bbb');
+            });
+            it('should handle case-sensitive replacement', () => {
+                expect(replaceText('Hello HELLO hello', 'hello', 'hi', true)).toBe('Hello HELLO hi');
+            });
+        });
+    });
+});

package/dist/src/tools/archive-page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"archive-page.d.ts","sourceRoot":"","sources":["../../../src/tools/archive-page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAQvD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAwBjF"}
+{"version":3,"file":"archive-page.d.ts","sourceRoot":"","sources":["../../../src/tools/archive-page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAQvD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAuBjF"}

package/dist/src/tools/create-page-simple.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-page-simple.d.ts","sourceRoot":"","sources":["../../../src/tools/create-page-simple.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAIxE,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAiBzE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAqEtF"}
+{"version":3,"file":"create-page-simple.d.ts","sourceRoot":"","sources":["../../../src/tools/create-page-simple.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAIxE,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAiBzE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA0EtF"}

package/dist/src/tools/create-page-simple.js

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { markdownToBlocks } from '../converters/index.js';
 import { isFullDataSource } from '../notion-client.js';
 import { F } from '../schemas/descriptions/index.js';
-import { formatResponse, handleErrorWithContext } from '../utils/index.js';
+import { formatSimpleResponse, handleErrorWithContext } from '../utils/index.js';
 // Minimal schema for MCP
 const inputSchema = {
     data_source_id: z.string().describe(F.data_source_id),
@@ -56,7 +56,11 @@ export function registerCreatePageSimple(server, notion) {
                 ...(children && { children }),
                 ...(icon && { icon: { type: 'emoji', emoji: icon } }),
             });
-            return formatResponse(response);
+            // Return minimal response (id + url only)
+            return formatSimpleResponse({
+                id: response.id,
+                url: 'url' in response ? response.url : undefined,
+            });
         }
         catch (error) {
             return handleErrorWithContext(error, notion, {

package/dist/src/tools/find-and-replace-in-page.d.ts

@@ -0,0 +1,14 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { NotionClient } from '../notion-client.js';
+/**
+ * Replace text in string with regex/string matching
+ * @internal Exported for testing
+ */
+export declare function replaceText(text: string, find: string, replace: string, useRegex: boolean): string;
+/**
+ * Check if text matches the find pattern
+ * @internal Exported for testing
+ */
+export declare function textMatches(text: string, find: string, useRegex: boolean): boolean;
+export declare function registerFindAndReplaceInPage(server: McpServer, notion: NotionClient): void;
+//# sourceMappingURL=find-and-replace-in-page.d.ts.map

package/dist/src/tools/find-and-replace-in-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-and-replace-in-page.d.ts","sourceRoot":"","sources":["../../../src/tools/find-and-replace-in-page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAIxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAyDvD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAWlG;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAWlF;AA4CD,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAsG1F"}

package/dist/src/tools/find-and-replace-in-page.js

@@ -0,0 +1,203 @@
+import { z } from 'zod';
+import { parseInlineMarkdown } from '../converters/index.js';
+import { F } from '../schemas/descriptions/index.js';
+import { formatSimpleResponse, handleError } from '../utils/index.js';
+const inputSchema = {
+    page_id: z.string().describe(F.page_id),
+    find: z.string().describe('Text to find (string or regex pattern if use_regex is true)'),
+    replace: z.string().describe('Replacement text (supports Markdown: **bold**, *italic*, etc.)'),
+    use_regex: z
+        .boolean()
+        .optional()
+        .describe('If true, treat find as a regex pattern (default: false)'),
+};
+// Block types that support text replacement
+const SUPPORTED_TYPES = [
+    'paragraph',
+    'heading_1',
+    'heading_2',
+    'heading_3',
+    'bulleted_list_item',
+    'numbered_list_item',
+    'to_do',
+    'quote',
+    'callout',
+    'toggle',
+];
+// ReDoS protection: timeout for regex execution
+const REGEX_TIMEOUT_MS = 1000;
+/**
+ * Extract plain text from rich_text array
+ */
+function extractPlainText(richText) {
+    return richText.map((rt) => rt.plain_text).join('');
+}
+/**
+ * Execute regex with timeout protection (ReDoS mitigation)
+ */
+function safeRegexTest(pattern, text, timeoutMs = REGEX_TIMEOUT_MS) {
+    const start = Date.now();
+    try {
+        // Simple timeout check (not perfect but helps with obvious ReDoS)
+        const result = pattern.test(text);
+        if (Date.now() - start > timeoutMs) {
+            throw new Error('Regex execution timeout');
+        }
+        return result;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Replace text in string with regex/string matching
+ * @internal Exported for testing
+ */
+export function replaceText(text, find, replace, useRegex) {
+    if (useRegex) {
+        try {
+            const regex = new RegExp(find, 'g');
+            return text.replace(regex, replace);
+        }
+        catch {
+            // Invalid regex, fall back to string replace
+            return text.split(find).join(replace);
+        }
+    }
+    return text.split(find).join(replace);
+}
+/**
+ * Check if text matches the find pattern
+ * @internal Exported for testing
+ */
+export function textMatches(text, find, useRegex) {
+    if (useRegex) {
+        try {
+            const regex = new RegExp(find);
+            return safeRegexTest(regex, text);
+        }
+        catch {
+            // Invalid regex, fall back to string match
+            return text.includes(find);
+        }
+    }
+    return text.includes(find);
+}
+/**
+ * Get all child blocks of a page (handles pagination)
+ */
+async function getAllChildBlocks(notion, pageId) {
+    const allBlocks = [];
+    let cursor;
+    do {
+        const response = await notion.blocks.children.list({
+            block_id: pageId,
+            start_cursor: cursor,
+            page_size: 100,
+        });
+        for (const block of response.results) {
+            if ('type' in block) {
+                allBlocks.push(block);
+            }
+        }
+        cursor = response.has_more ? response.next_cursor ?? undefined : undefined;
+    } while (cursor);
+    return allBlocks;
+}
+/**
+ * Get rich_text from a block based on its type
+ */
+function getBlockRichText(block) {
+    const blockType = block.type;
+    if (!SUPPORTED_TYPES.includes(blockType)) {
+        return null;
+    }
+    const blockData = block[blockType];
+    return blockData?.rich_text ?? null;
+}
+export function registerFindAndReplaceInPage(server, notion) {
+    server.registerTool('find-and-replace-in-page', {
+        description: 'Find text in a page and replace it with new content. ' +
+            'Supports regex patterns (use_regex: true) for advanced matching (e.g., "item\\d+" matches item1, item2). ' +
+            'All matching blocks will be updated. ' +
+            'Replacement text supports Markdown formatting: **bold**, *italic*, ~~strikethrough~~, `code`, [links](url). ' +
+            'Only works with text-based blocks: paragraph, headings, lists, to_do, quote, callout, toggle. ' +
+            'Use this for partial updates. For full page rewrite, use replace-page-content instead.',
+        inputSchema,
+    }, async ({ page_id, find, replace, use_regex }) => {
+        try {
+            const useRegex = use_regex ?? false;
+            // Validate regex if enabled
+            if (useRegex) {
+                try {
+                    new RegExp(find);
+                }
+                catch (e) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Error: Invalid regex pattern: ${find}. ${e instanceof Error ? e.message : ''}`,
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+            }
+            // 1. Get all blocks from the page
+            const allBlocks = await getAllChildBlocks(notion, page_id);
+            // 2. Find blocks that match the search pattern
+            const matchingBlocks = [];
+            for (const block of allBlocks) {
+                const richText = getBlockRichText(block);
+                if (!richText)
+                    continue;
+                const plainText = extractPlainText(richText);
+                if (textMatches(plainText, find, useRegex)) {
+                    const newText = replaceText(plainText, find, replace, useRegex);
+                    matchingBlocks.push({
+                        block,
+                        originalText: plainText,
+                        newText,
+                    });
+                }
+            }
+            if (matchingBlocks.length === 0) {
+                return formatSimpleResponse({
+                    updated_count: 0,
+                    message: 'No matching blocks found',
+                });
+            }
+            // 3. Update matching blocks
+            const updatedIds = [];
+            for (const { block, newText } of matchingBlocks) {
+                const blockType = block.type;
+                const richText = parseInlineMarkdown(newText);
+                const params = {
+                    block_id: block.id,
+                };
+                // Preserve checked state for to_do blocks
+                if (blockType === 'to_do' && block.type === 'to_do') {
+                    params[blockType] = {
+                        rich_text: richText,
+                        checked: block.to_do.checked ?? false,
+                    };
+                }
+                else {
+                    params[blockType] = {
+                        rich_text: richText,
+                    };
+                }
+                await notion.blocks.update(params);
+                updatedIds.push(block.id);
+            }
+            return formatSimpleResponse({
+                updated_count: updatedIds.length,
+                updated_block_ids: updatedIds,
+            });
+        }
+        catch (error) {
+            return handleError(error);
+        }
+    });
+}

package/dist/src/tools/index.d.ts

@@ -10,6 +10,8 @@ import { registerCreateDatabase } from './create-database.js';
 import { registerCreatePage } from './create-page.js';
 import { registerCreatePageSimple } from './create-page-simple.js';
 import { registerDeleteBlock } from './delete-block.js';
+import { registerFindAndReplaceInPage } from './find-and-replace-in-page.js';
+import { registerReplacePageContent } from './replace-page-content.js';
 import { registerGetBlockChildren } from './get-block-children.js';
 import { registerListComments } from './list-comments.js';
 import { registerListUsers } from './list-users.js';
@@ -29,5 +31,5 @@ import { registerUpdateDataSource } from './update-data-source.js';
 import { registerUpdateDatabase } from './update-database.js';
 import { registerUpdatePage } from './update-page.js';
 export declare function registerAllTools(server: McpServer, notion: NotionClient): void;
-export { registerRetrievePage, registerCreatePage, registerCreatePageSimple, registerUpdatePage, registerArchivePage, registerRetrievePageProperty, registerMovePage, registerCreateDatabase, registerUpdateDatabase, registerArchiveDatabase, registerRetrieveDatabase, registerRetrieveDataSource, registerQueryDataSource, registerUpdateDataSource, registerSearch, registerGetBlockChildren, registerAppendBlockChildren, registerAppendBlocksSimple, registerRetrieveBlock, registerUpdateBlock, registerUpdateBlockSimple, registerDeleteBlock, registerCreateComment, registerCreateCommentSimple, registerListComments, registerListUsers, registerRetrieveUser, registerRetrieveBotUser, };
+export { registerRetrievePage, registerCreatePage, registerCreatePageSimple, registerUpdatePage, registerArchivePage, registerRetrievePageProperty, registerMovePage, registerCreateDatabase, registerUpdateDatabase, registerArchiveDatabase, registerRetrieveDatabase, registerRetrieveDataSource, registerQueryDataSource, registerUpdateDataSource, registerSearch, registerGetBlockChildren, registerAppendBlockChildren, registerAppendBlocksSimple, registerRetrieveBlock, registerUpdateBlock, registerUpdateBlockSimple, registerDeleteBlock, registerReplacePageContent, registerFindAndReplaceInPage, registerCreateComment, registerCreateCommentSimple, registerListComments, registerListUsers, registerRetrieveUser, registerRetrieveBotUser, };
 //# sourceMappingURL=index.d.ts.map

package/dist/src/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAA;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAA;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAA;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAA;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAA;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAErD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA0C9E;AAED,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,4BAA4B,EAC5B,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,mBAAmB,EACnB,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,2BAA2B,EAC3B,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,GACxB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAA;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAA;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAA;AAC5E,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAA;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAA;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAA;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAErD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA4C9E;AAED,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,4BAA4B,EAC5B,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,mBAAmB,EACnB,yBAAyB,EACzB,mBAAmB,EACnB,0BAA0B,EAC1B,4BAA4B,EAC5B,qBAAqB,EACrB,2BAA2B,EAC3B,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,GACxB,CAAA"}

package/dist/src/tools/index.js

@@ -8,6 +8,8 @@ import { registerCreateDatabase } from './create-database.js';
 import { registerCreatePage } from './create-page.js';
 import { registerCreatePageSimple } from './create-page-simple.js';
 import { registerDeleteBlock } from './delete-block.js';
+import { registerFindAndReplaceInPage } from './find-and-replace-in-page.js';
+import { registerReplacePageContent } from './replace-page-content.js';
 import { registerGetBlockChildren } from './get-block-children.js';
 import { registerListComments } from './list-comments.js';
 import { registerListUsers } from './list-users.js';
@@ -54,6 +56,8 @@ export function registerAllTools(server, notion) {
     registerUpdateBlock(server, notion);
     registerUpdateBlockSimple(server, notion);
     registerDeleteBlock(server, notion);
+    registerReplacePageContent(server, notion);
+    registerFindAndReplaceInPage(server, notion);
     // Comment operations
     registerCreateComment(server, notion);
     registerCreateCommentSimple(server, notion);
@@ -63,4 +67,4 @@ export function registerAllTools(server, notion) {
     registerRetrieveUser(server, notion);
     registerRetrieveBotUser(server, notion);
 }
-export { registerRetrievePage, registerCreatePage, registerCreatePageSimple, registerUpdatePage, registerArchivePage, registerRetrievePageProperty, registerMovePage, registerCreateDatabase, registerUpdateDatabase, registerArchiveDatabase, registerRetrieveDatabase, registerRetrieveDataSource, registerQueryDataSource, registerUpdateDataSource, registerSearch, registerGetBlockChildren, registerAppendBlockChildren, registerAppendBlocksSimple, registerRetrieveBlock, registerUpdateBlock, registerUpdateBlockSimple, registerDeleteBlock, registerCreateComment, registerCreateCommentSimple, registerListComments, registerListUsers, registerRetrieveUser, registerRetrieveBotUser, };
+export { registerRetrievePage, registerCreatePage, registerCreatePageSimple, registerUpdatePage, registerArchivePage, registerRetrievePageProperty, registerMovePage, registerCreateDatabase, registerUpdateDatabase, registerArchiveDatabase, registerRetrieveDatabase, registerRetrieveDataSource, registerQueryDataSource, registerUpdateDataSource, registerSearch, registerGetBlockChildren, registerAppendBlockChildren, registerAppendBlocksSimple, registerRetrieveBlock, registerUpdateBlock, registerUpdateBlockSimple, registerDeleteBlock, registerReplacePageContent, registerFindAndReplaceInPage, registerCreateComment, registerCreateCommentSimple, registerListComments, registerListUsers, registerRetrieveUser, registerRetrieveBotUser, };

package/dist/src/tools/replace-page-content.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { NotionClient } from '../notion-client.js';
+export declare function registerReplacePageContent(server: McpServer, notion: NotionClient): void;
+//# sourceMappingURL=replace-page-content.d.ts.map

package/dist/src/tools/replace-page-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace-page-content.d.ts","sourceRoot":"","sources":["../../../src/tools/replace-page-content.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAIxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AA+CvD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA+ExF"}

package/dist/src/tools/replace-page-content.js

@@ -0,0 +1,96 @@
+import { z } from 'zod';
+import { markdownToBlocks } from '../converters/index.js';
+import { F } from '../schemas/descriptions/index.js';
+import { formatSimpleResponse, handleError } from '../utils/index.js';
+const inputSchema = {
+    page_id: z.string().describe(F.page_id),
+    content: z.string().describe(F.content),
+    dry_run: z
+        .boolean()
+        .optional()
+        .describe('Preview mode: shows which blocks will be deleted without actually modifying the page (default: false)'),
+};
+// Block types to preserve (not delete)
+const PRESERVE_TYPES = ['child_database', 'child_page'];
+/**
+ * Get all child blocks of a page (handles pagination)
+ */
+async function getAllChildBlocks(notion, pageId) {
+    const allBlocks = [];
+    let cursor;
+    do {
+        const response = await notion.blocks.children.list({
+            block_id: pageId,
+            start_cursor: cursor,
+            page_size: 100,
+        });
+        for (const block of response.results) {
+            if ('type' in block) {
+                allBlocks.push(block);
+            }
+        }
+        cursor = response.has_more ? response.next_cursor ?? undefined : undefined;
+    } while (cursor);
+    return allBlocks;
+}
+export function registerReplacePageContent(server, notion) {
+    server.registerTool('replace-page-content', {
+        description: 'Replace all page content with Markdown. Preserves child_database/child_page only. ' +
+            'WARNING: Non-Markdown blocks (bookmark, callout, equation, etc.) will be DELETED. ' +
+            'Use dry_run: true to preview deletions. For partial updates, use find-and-replace-in-page.',
+        inputSchema,
+    }, async ({ page_id, content, dry_run }) => {
+        try {
+            const isDryRun = dry_run ?? false;
+            // 1. Get all existing blocks
+            const existingBlocks = await getAllChildBlocks(notion, page_id);
+            // 2. Identify blocks to delete (not in PRESERVE_TYPES)
+            const blocksToDelete = existingBlocks.filter((block) => !PRESERVE_TYPES.includes(block.type));
+            // 3. Identify blocks to preserve
+            const blocksToPreserve = existingBlocks.filter((block) => PRESERVE_TYPES.includes(block.type));
+            // If dry_run, return preview without making changes
+            if (isDryRun) {
+                // Group blocks by type for readable output
+                const deleteByType = {};
+                for (const block of blocksToDelete) {
+                    deleteByType[block.type] = (deleteByType[block.type] ?? 0) + 1;
+                }
+                const preserveByType = {};
+                for (const block of blocksToPreserve) {
+                    preserveByType[block.type] = (preserveByType[block.type] ?? 0) + 1;
+                }
+                return formatSimpleResponse({
+                    dry_run: true,
+                    will_delete_count: blocksToDelete.length,
+                    will_delete_by_type: deleteByType,
+                    will_preserve_count: blocksToPreserve.length,
+                    will_preserve_by_type: preserveByType,
+                    message: 'No changes made. Set dry_run: false to execute.',
+                });
+            }
+            // 4. Actually delete blocks
+            const deletedIds = [];
+            for (const block of blocksToDelete) {
+                await notion.blocks.delete({ block_id: block.id });
+                deletedIds.push(block.id);
+            }
+            // 5. Convert markdown to blocks
+            const newBlocks = markdownToBlocks(content);
+            // 6. Append new blocks
+            const appendResponse = await notion.blocks.children.append({
+                block_id: page_id,
+                children: newBlocks,
+            });
+            const createdIds = appendResponse.results.map((block) => block.id);
+            // Return minimal response
+            return formatSimpleResponse({
+                deleted_count: deletedIds.length,
+                created_count: createdIds.length,
+                preserved_types: PRESERVE_TYPES,
+            });
+        }
+        catch (error) {
+            return handleError(error);
+        }
+    });
+}

package/dist/src/tools/update-block-simple.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-block-simple.d.ts","sourceRoot":"","sources":["../../../src/tools/update-block-simple.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAyBpE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAiEvF"}
+{"version":3,"file":"update-block-simple.d.ts","sourceRoot":"","sources":["../../../src/tools/update-block-simple.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAyBpE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAsEvF"}

package/dist/src/tools/update-block-simple.js

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { parseInlineMarkdown } from '../converters/index.js';
 import { isFullBlock } from '../notion-client.js';
 import { F } from '../schemas/descriptions/index.js';
-import { formatResponse, handleError } from '../utils/index.js';
+import { formatSimpleResponse, handleError } from '../utils/index.js';
 const inputSchema = {
     block_id: z.string().describe(F.block_id),
     content: z.string().describe(F.content),
@@ -24,7 +24,8 @@ export function registerUpdateBlockSimple(server, notion) {
     server.registerTool('update-block-simple', {
         description: 'Update a text block using Markdown. Simpler than update-block: just provide markdown text. ' +
             'Supports inline formatting: **bold**, *italic*, ~~strikethrough~~, `code`, [links](url). ' +
-            'Only works with text-based blocks: paragraph, headings, lists, to_do, quote, callout, toggle.',
+            'Only works with text-based blocks: paragraph, headings, lists, to_do, quote, callout, toggle. ' +
+            'Requires block_id. If you want to update by text search, use find-and-replace-in-page. For full page rewrite, use replace-page-content.',
         inputSchema,
     }, async ({ block_id, content }) => {
         try {
@@ -69,7 +70,10 @@ export function registerUpdateBlockSimple(server, notion) {
                 };
             }
             const response = await notion.blocks.update(params);
-            return formatResponse(response);
+            // Return minimal response (id only)
+            return formatSimpleResponse({
+                id: response.id,
+            });
         }
         catch (error) {
             return handleError(error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atikk-co-jp/notion-mcp-server",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "MCP server for Notion API - Create, read, update pages and databases",
   "type": "module",
   "license": "MIT",