@atikk-co-jp/notion-mcp-server 0.12.0 → 0.14.0

package/README.ja.md

@@ -120,7 +120,9 @@ Notionのタスクデータベースから、特定の条件でタスクを取
 | | [Update block](https://developers.notion.com/reference/update-a-block) | `update-block` 📤 | JSON | `{id}` |
 | | | `update-block-simple` ⭐📤 | Markdown | `{id}` |
 | | [Delete block](https://developers.notion.com/reference/delete-a-block) | `delete-block` 📤 | JSON | `{id}` |
-| | [Retrieve block children](https://developers.notion.com/reference/get-block-children) | `get-block-children` | JSON | **markdown**/json |
+| | | `delete-blocks-batch` 📤 | JSON | `{deleted_count, failed_count}` |
+| | | `clear-page-content` 📤 | JSON | `{deleted_count, failed_count}` |
+| | [Retrieve block children](https://developers.notion.com/reference/get-block-children) | `get-block-children` | JSON | **markdown**/simple/json |
 | | [Append block children](https://developers.notion.com/reference/patch-block-children) | `append-block-children` 📤 | JSON | `{block_ids}` |
 | | | `append-blocks-simple` ⭐📤 | Markdown | `{block_ids}` |
 | **ページコンテンツ** | | | | |
@@ -226,6 +228,7 @@ Markdownを使ってページを作成します。`create-page`と比較して**
 - ブックマーク: `[bookmark](url)` または `[bookmark:キャプション](url)`
 - カラム: `:::columns` / `:::column` / `:::`
 - メディア: `@[embed](url)`, `@[video](url)`, `@[audio](url)`, `@[file](url)`, `@[pdf](url)`
+- 目次: `[TOC]`
 
 **子ページを作成:**
 ```json
@@ -409,8 +412,9 @@ Markdownを使ってページを作成します。`create-page`と比較して**
 - `block_id` (必須): 子ブロックを取得するブロックまたはページのID
 - `start_cursor` (任意): ページネーション用カーソル
 - `page_size` (任意): 返す結果の数 (1-100)
-- `format` (任意): 出力形式 - `"markdown"` (デフォルト) または `"json"`
+- `format` (任意): 出力形式 - `"markdown"` (デフォルト)、`"simple"`、または `"json"`
   - `markdown`: トークン使用量を大幅に削減（約96%削減）した人間が読みやすいマークダウン形式
+  - `simple`: ID + タイプ + Markdownコンテンツ（軽量、削除対象選定用）
   - `json`: Notion APIのレスポンスをそのまま返す
 - `fetch_nested` (任意): `format="markdown"`の時、ネストされた子ブロックを再帰的に取得する（デフォルト: false）
 
@@ -422,6 +426,25 @@ Markdownを使ってページを作成します。`create-page`と比較して**
 }
 ```
 
+**削除対象のブロックIDを取得:**
+```json
+{
+  "block_id": "ページまたはブロックのUUID",
+  "format": "simple"
+}
+```
+
+レスポンス:
+```json
+{
+  "blocks": [
+    { "id": "abc123", "type": "heading_1", "content": "# タイトル" },
+    { "id": "def456", "type": "paragraph", "content": "本文テキスト" }
+  ],
+  "has_more": false
+}
+```
+
 ### append-block-children
 
 ページまたはブロックに新しいブロックを追加します。
@@ -529,6 +552,62 @@ Markdownを使ってブロックを追加します。`append-block-children`と
 
 **対象ブロックタイプ:** paragraph, heading_1/2/3, bulleted_list_item, numbered_list_item, to_do, quote, callout, toggle
 
+### delete-blocks-batch
+
+複数のブロックをIDで一括削除します。APIレート制限（3 req/s）を尊重して順次削除します。
+
+**パラメータ:**
+- `block_ids` (必須): 削除するブロックIDの配列（最大100件）
+
+**使い分け:** 特定のブロックを選んで削除したい場合。事前に `get-block-children` で `format="simple"` を使ってブロックIDを取得してください。
+
+```json
+{
+  "block_ids": ["block-uuid-1", "block-uuid-2", "block-uuid-3"]
+}
+```
+
+レスポンス:
+```json
+{
+  "deleted_count": 3,
+  "failed_count": 0,
+  "deleted": ["block-uuid-1", "block-uuid-2", "block-uuid-3"]
+}
+```
+
+### clear-page-content
+
+ページの全コンテンツを削除します。デフォルトで `child_database` と `child_page` ブロックは保護されます。
+
+**パラメータ:**
+- `page_id` (必須): 削除するページのID
+- `preserve_types` (任意): 保護するブロックタイプ（デフォルト: `["child_database", "child_page"]`）。`[]`を指定するとすべて削除。
+
+**使い分け:** 個々のブロックを選択せずにページ全体のコンテンツを削除したい場合。
+
+```json
+{
+  "page_id": "ページのUUID"
+}
+```
+
+**すべて削除（子データベース/ページも含む）:**
+```json
+{
+  "page_id": "ページのUUID",
+  "preserve_types": []
+}
+```
+
+レスポンス:
+```json
+{
+  "deleted_count": 15,
+  "failed_count": 0
+}
+```
+
 ### create-comment
 
 ページにコメントを追加します。

package/README.md

@@ -120,7 +120,9 @@ That's it! Restart your AI client and start using Notion.
 | | [Update block](https://developers.notion.com/reference/update-a-block) | `update-block` 📤 | JSON | `{id}` |
 | | | `update-block-simple` ⭐📤 | Markdown | `{id}` |
 | | [Delete block](https://developers.notion.com/reference/delete-a-block) | `delete-block` 📤 | JSON | `{id}` |
-| | [Retrieve block children](https://developers.notion.com/reference/get-block-children) | `get-block-children` | JSON | **markdown**/json |
+| | | `delete-blocks-batch` 📤 | JSON | `{deleted_count, failed_count}` |
+| | | `clear-page-content` 📤 | JSON | `{deleted_count, failed_count}` |
+| | [Retrieve block children](https://developers.notion.com/reference/get-block-children) | `get-block-children` | JSON | **markdown**/simple/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}` |
@@ -225,6 +227,7 @@ Supports two parent types:
 - Bookmark: `[bookmark](url)` or `[bookmark:caption](url)`
 - Columns: `:::columns` / `:::column` / `:::`
 - Media: `@[embed](url)`, `@[video](url)`, `@[audio](url)`, `@[file](url)`, `@[pdf](url)`
+- Table of contents: `[TOC]`
 
 **Create a child page:**
 ```json
@@ -408,8 +411,9 @@ Get the child blocks of a page or block.
 - `block_id` (required): The ID of the block or page to get children from
 - `start_cursor` (optional): Cursor for pagination
 - `page_size` (optional): Number of results to return (1-100)
-- `format` (optional): Output format - `"markdown"` (default) or `"json"`
+- `format` (optional): Output format - `"markdown"` (default), `"simple"`, or `"json"`
   - `markdown`: Returns human-readable markdown with significantly reduced token usage (~96% reduction)
+  - `simple`: Returns ID + type + markdown content (lightweight, for deletion target selection)
   - `json`: Returns raw Notion API response
 - `fetch_nested` (optional): When `format="markdown"`, fetch nested children blocks recursively (default: false)
 
@@ -421,6 +425,25 @@ Get the child blocks of a page or block.
 }
 ```
 
+**Get block IDs for deletion:**
+```json
+{
+  "block_id": "page-or-block-uuid-here",
+  "format": "simple"
+}
+```
+
+Returns:
+```json
+{
+  "blocks": [
+    { "id": "abc123", "type": "heading_1", "content": "# Title" },
+    { "id": "def456", "type": "paragraph", "content": "Some text" }
+  ],
+  "has_more": false
+}
+```
+
 ### append-block-children
 
 Append new blocks to a page or block.
@@ -524,6 +547,62 @@ Find text in a page and replace it with new content. Supports regex patterns for
 }
 ```
 
+### delete-blocks-batch
+
+Delete multiple blocks by their IDs. Blocks are deleted sequentially to respect API rate limits (3 req/s).
+
+**Parameters:**
+- `block_ids` (required): Array of block IDs to delete (max 100)
+
+**Use when:** You want to delete specific blocks. Use `get-block-children` with `format="simple"` to get block IDs first.
+
+```json
+{
+  "block_ids": ["block-uuid-1", "block-uuid-2", "block-uuid-3"]
+}
+```
+
+Returns:
+```json
+{
+  "deleted_count": 3,
+  "failed_count": 0,
+  "deleted": ["block-uuid-1", "block-uuid-2", "block-uuid-3"]
+}
+```
+
+### clear-page-content
+
+Delete all content from a page. By default, preserves `child_database` and `child_page` blocks.
+
+**Parameters:**
+- `page_id` (required): The page ID to clear
+- `preserve_types` (optional): Block types to preserve (default: `["child_database", "child_page"]`). Set to `[]` to delete all.
+
+**Use when:** You want to delete all content from a page without selecting individual blocks.
+
+```json
+{
+  "page_id": "page-uuid-here"
+}
+```
+
+**Delete everything (including child databases/pages):**
+```json
+{
+  "page_id": "page-uuid-here",
+  "preserve_types": []
+}
+```
+
+Returns:
+```json
+{
+  "deleted_count": 15,
+  "failed_count": 0
+}
+```
+
 ### create-comment
 
 Add a comment to a page.

package/dist/src/converters/__tests__/markdown-to-blocks.test.js

@@ -791,4 +791,32 @@ const x = 1
             expect(result[3].type).toBe('paragraph');
         });
     });
+    describe('table_of_contents', () => {
+        it('converts [TOC] to table_of_contents', () => {
+            const blocks = markdownToBlocks('[TOC]');
+            expect(blocks).toHaveLength(1);
+            expect(blocks[0].type).toBe('table_of_contents');
+            expect(getBlockProp(blocks[0], 'table_of_contents')).toEqual({ color: 'default' });
+        });
+        it('converts [toc] (lowercase) to table_of_contents', () => {
+            const blocks = markdownToBlocks('[toc]');
+            expect(blocks).toHaveLength(1);
+            expect(blocks[0].type).toBe('table_of_contents');
+        });
+        it('converts [Toc] (mixed case) to table_of_contents', () => {
+            const blocks = markdownToBlocks('[Toc]');
+            expect(blocks).toHaveLength(1);
+            expect(blocks[0].type).toBe('table_of_contents');
+        });
+        it('handles [TOC] with surrounding whitespace', () => {
+            const blocks = markdownToBlocks('  [TOC]  ');
+            expect(blocks).toHaveLength(1);
+            expect(blocks[0].type).toBe('table_of_contents');
+        });
+        it('does not convert [TOC] inside text', () => {
+            const blocks = markdownToBlocks('See [TOC] for details');
+            expect(blocks).toHaveLength(1);
+            expect(blocks[0].type).toBe('paragraph');
+        });
+    });
 });

package/dist/src/converters/markdown-to-blocks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown-to-blocks.d.ts","sourceRoot":"","sources":["../../../src/converters/markdown-to-blocks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAO7D;;GAEG;AACH,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,CAAC,EAAE;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAA;KAC9B,CAAA;IACD,WAAW,CAAC,EAAE;QACZ,IAAI,CAAC,EAAE,OAAO,CAAA;QACd,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB,aAAa,CAAC,EAAE,OAAO,CAAA;QACvB,SAAS,CAAC,EAAE,OAAO,CAAA;QACnB,IAAI,CAAC,EAAE,OAAO,CAAA;QACd,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;CACF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE,CA6JnE;AAmBD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAqcvE"}
+{"version":3,"file":"markdown-to-blocks.d.ts","sourceRoot":"","sources":["../../../src/converters/markdown-to-blocks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAO7D;;GAEG;AACH,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,CAAC,EAAE;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAA;KAC9B,CAAA;IACD,WAAW,CAAC,EAAE;QACZ,IAAI,CAAC,EAAE,OAAO,CAAA;QACd,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB,aAAa,CAAC,EAAE,OAAO,CAAA;QACvB,SAAS,CAAC,EAAE,OAAO,CAAA;QACnB,IAAI,CAAC,EAAE,OAAO,CAAA;QACd,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;CACF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE,CA6JnE;AAmBD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,EAAE,CA+cvE"}

package/dist/src/converters/markdown-to-blocks.js

@@ -232,6 +232,15 @@ export function markdownToBlocks(markdown) {
             i++;
             continue;
         }
+        // 目次: [TOC] (case-insensitive)
+        if (/^\[toc\]$/i.test(line.trim())) {
+            blocks.push({
+                type: 'table_of_contents',
+                table_of_contents: { color: 'default' },
+            });
+            i++;
+            continue;
+        }
         // 見出し: # ## ### (####以上はheading_3にフォールバック)
         const headingMatch = line.match(/^(#{1,6})\s+(.+)$/);
         if (headingMatch) {

package/dist/src/schemas/descriptions/fields.d.ts

@@ -54,7 +54,10 @@ export declare const Fields: {
         readonly desc: "Number of results (1-100)";
     };
     readonly format: {
-        readonly desc: "Output format: 'simple' or 'json'";
+        readonly desc: {
+            readonly default: "Output format: 'simple' or 'json'";
+            readonly block_children: "Output format: 'markdown' (default, human-readable), 'simple' (ID + type + content, for deletion), 'json' (full API response)";
+        };
     };
     readonly properties: {
         readonly desc: {
@@ -149,6 +152,7 @@ export declare const F: { [K in keyof typeof Fields]: string; } & {
     data_source_id_target: string;
     properties_schema: string;
     properties_update: string;
+    format_block_children: string;
     filter_search: string;
     icon_emoji: string;
     markdown_syntax_short: string;

package/dist/src/schemas/descriptions/fields.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../../../src/schemas/descriptions/fields.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAA;CAC9D;AAED;;;GAGG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqL2B,CAAA;AAE9C;;;;;;;GAOG;AACH,eAAO,MAAM,CAAC,EAgBN,GAAG,CAAC,IAAI,MAAM,OAAO,MAAM,GAAG,MAAM,GAAE,GAAG;IAE/C,cAAc,EAAE,MAAM,CAAA;IACtB,qBAAqB,EAAE,MAAM,CAAA;IAC7B,iBAAiB,EAAE,MAAM,CAAA;IACzB,iBAAiB,EAAE,MAAM,CAAA;IACzB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,qBAAqB,EAAE,MAAM,CAAA;CAC9B,CAAA"}
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../../../src/schemas/descriptions/fields.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAA;CAC9D;AAED;;;GAGG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyL2B,CAAA;AAE9C;;;;;;;GAOG;AACH,eAAO,MAAM,CAAC,EAgBN,GAAG,CAAC,IAAI,MAAM,OAAO,MAAM,GAAG,MAAM,GAAE,GAAG;IAE/C,cAAc,EAAE,MAAM,CAAA;IACtB,qBAAqB,EAAE,MAAM,CAAA;IAC7B,iBAAiB,EAAE,MAAM,CAAA;IACzB,iBAAiB,EAAE,MAAM,CAAA;IACzB,qBAAqB,EAAE,MAAM,CAAA;IAC7B,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,qBAAqB,EAAE,MAAM,CAAA;CAC9B,CAAA"}

package/dist/src/schemas/descriptions/fields.js

@@ -53,7 +53,10 @@ export const Fields = {
     // Format
     // ============================================
     format: {
-        desc: "Output format: 'simple' or 'json'",
+        desc: {
+            default: "Output format: 'simple' or 'json'",
+            block_children: "Output format: 'markdown' (default, human-readable), 'simple' (ID + type + content, for deletion), 'json' (full API response)",
+        },
     },
     // ============================================
     // Properties
@@ -81,9 +84,9 @@ export const Fields = {
         desc: {
             default: 'Markdown: # headings, - lists, - [ ] checkboxes, ``` code, > quotes, | tables |, ![]() images, **bold**, *italic*, ~~strike~~, `code`, [links](). ' +
                 'Extended: <details><summary> toggle, > [!NOTE/WARNING/TIP/IMPORTANT/CAUTION] callout, $$ equation, <u>/++ underline, {color:x}{/color}, {bg:x}{/bg}, ' +
-                '[bookmark](), :::columns, @[embed/video/audio/file/pdf]().',
+                '[bookmark](), :::columns, @[embed/video/audio/file/pdf](), [TOC] table of contents.',
             short: '# headings, - lists, - [ ] checkboxes, ``` code, > quotes, | tables |, **bold**, *italic*, [links](), ' +
-                '<details> toggle, > [!NOTE] callout, $$ equation.',
+                '<details> toggle, > [!NOTE] callout, $$ equation, [TOC] table of contents.',
         },
     },
     // ============================================

package/dist/src/tools/__tests__/context-size.test.js

@@ -133,7 +133,7 @@ describe('Tool context size', () => {
         });
     });
     describe('Description length checks', () => {
-        const MAX_DESCRIPTION_LENGTH = 500;
+        const MAX_DESCRIPTION_LENGTH = 600;
         it.each(toolNames)('%s description should be concise', (toolName) => {
             const tool = registeredTools[toolName];
             const descLength = tool.description?.length ?? 0;

package/dist/src/tools/clear-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 registerClearPageContent(server: McpServer, notion: NotionClient): void;
+//# sourceMappingURL=clear-page-content.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clear-page-content.d.ts","sourceRoot":"","sources":["../../../src/tools/clear-page-content.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAcpE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAmEtF"}

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

@@ -0,0 +1,63 @@
+import { z } from 'zod';
+import { isFullBlock } from '../notion-client.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),
+    preserve_types: z
+        .array(z.string())
+        .optional()
+        .describe('Block types to preserve (default: ["child_database", "child_page"]). Set to empty array [] to delete all.'),
+};
+export function registerClearPageContent(server, notion) {
+    server.registerTool('clear-page-content', {
+        description: 'Delete all content from a page. By default, preserves child_database and child_page blocks. ' +
+            'Use preserve_types=[] to delete everything. ' +
+            'For deleting specific blocks, use delete-blocks-batch instead. ' +
+            'Blocks are deleted sequentially to respect API rate limits (3 req/s). ' +
+            'Returns count of deleted blocks.',
+        inputSchema,
+    }, async ({ page_id, preserve_types = ['child_database', 'child_page'], }) => {
+        try {
+            // Collect all blocks to delete (handle pagination)
+            const blocksToDelete = [];
+            let cursor;
+            do {
+                const response = await notion.blocks.children.list({
+                    block_id: page_id,
+                    start_cursor: cursor,
+                });
+                const blocks = response.results.filter(isFullBlock);
+                for (const block of blocks) {
+                    if (!preserve_types.includes(block.type)) {
+                        blocksToDelete.push(block.id);
+                    }
+                }
+                cursor = response.has_more ? (response.next_cursor ?? undefined) : undefined;
+            } while (cursor);
+            // Delete blocks
+            let deleted = 0;
+            const failed = [];
+            for (const id of blocksToDelete) {
+                try {
+                    await notion.blocks.delete({ block_id: id });
+                    deleted++;
+                }
+                catch (e) {
+                    failed.push({
+                        id,
+                        error: e instanceof Error ? e.message : String(e),
+                    });
+                }
+            }
+            return formatSimpleResponse({
+                deleted_count: deleted,
+                failed_count: failed.length,
+                failed: failed.length > 0 ? failed : undefined,
+            });
+        }
+        catch (error) {
+            return handleError(error);
+        }
+    });
+}

package/dist/src/tools/delete-blocks-batch.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 registerDeleteBlocksBatch(server: McpServer, notion: NotionClient): void;
+//# sourceMappingURL=delete-blocks-batch.d.ts.map

package/dist/src/tools/delete-blocks-batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-blocks-batch.d.ts","sourceRoot":"","sources":["../../../src/tools/delete-blocks-batch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAWvD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAyCvF"}

package/dist/src/tools/delete-blocks-batch.js

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import { formatSimpleResponse, handleError } from '../utils/index.js';
+const inputSchema = {
+    block_ids: z
+        .array(z.string())
+        .min(1)
+        .max(100)
+        .describe('Block IDs to delete (max 100). Use get-block-children with format="simple" to get IDs.'),
+};
+export function registerDeleteBlocksBatch(server, notion) {
+    server.registerTool('delete-blocks-batch', {
+        description: 'Delete multiple blocks by their IDs. Use this when you want to delete specific blocks. ' +
+            'For deleting all content from a page, use clear-page-content instead. ' +
+            'Blocks are deleted sequentially to respect API rate limits (3 req/s). ' +
+            'Returns summary of deleted and failed blocks.',
+        inputSchema,
+    }, async ({ block_ids }) => {
+        try {
+            const results = {
+                deleted: [],
+                failed: [],
+            };
+            for (const id of block_ids) {
+                try {
+                    await notion.blocks.delete({ block_id: id });
+                    results.deleted.push(id);
+                }
+                catch (e) {
+                    results.failed.push({
+                        id,
+                        error: e instanceof Error ? e.message : String(e),
+                    });
+                }
+            }
+            return formatSimpleResponse({
+                deleted_count: results.deleted.length,
+                failed_count: results.failed.length,
+                deleted: results.deleted,
+                failed: results.failed.length > 0 ? results.failed : undefined,
+            });
+        }
+        catch (error) {
+            return handleError(error);
+        }
+    });
+}

package/dist/src/tools/get-block-children.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-block-children.d.ts","sourceRoot":"","sources":["../../../src/tools/get-block-children.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,EAAyC,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAY9F,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA4CtF"}
+{"version":3,"file":"get-block-children.d.ts","sourceRoot":"","sources":["../../../src/tools/get-block-children.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,EAAyC,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAqB9F,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA6DtF"}

package/dist/src/tools/get-block-children.js

@@ -2,12 +2,16 @@ import { z } from 'zod';
 import { blocksToMarkdown } from '../converters/index.js';
 import { isFullBlock } from '../notion-client.js';
 import { F } from '../schemas/descriptions/index.js';
-import { formatMarkdownResponse, formatPaginatedResponse, handleError } from '../utils/index.js';
+import { formatMarkdownResponse, formatPaginatedResponse, formatSimpleResponse, handleError, } from '../utils/index.js';
 const inputSchema = {
     block_id: z.string().describe(F.block_id),
     start_cursor: z.string().optional().describe(F.start_cursor),
     page_size: z.number().min(1).max(100).optional().describe(F.page_size),
-    format: z.enum(['json', 'markdown']).optional().default('markdown').describe(F.format),
+    format: z
+        .enum(['json', 'markdown', 'simple'])
+        .optional()
+        .default('markdown')
+        .describe(F.format_block_children),
     fetch_nested: z.boolean().optional().default(false).describe(F.fetch_nested),
 };
 export function registerGetBlockChildren(server, notion) {
@@ -39,6 +43,19 @@ export function registerGetBlockChildren(server, notion) {
                 }
                 return formatMarkdownResponse(markdown, response.has_more, response.next_cursor);
             }
+            if (format === 'simple') {
+                // Simple format: ID + type + markdown content (lightweight, for deletion target selection)
+                const simpleBlocks = await Promise.all(blocks.map(async (block) => ({
+                    id: block.id,
+                    type: block.type,
+                    content: await blocksToMarkdown([block]),
+                })));
+                return formatSimpleResponse({
+                    blocks: simpleBlocks,
+                    has_more: response.has_more,
+                    next_cursor: response.next_cursor,
+                });
+            }
             // JSON形式
             return formatPaginatedResponse(response.results, response.has_more, response.next_cursor);
         }

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

@@ -4,12 +4,14 @@ import { registerAppendBlockChildren } from './append-block-children.js';
 import { registerAppendBlocksSimple } from './append-blocks-simple.js';
 import { registerArchiveDatabase } from './archive-database.js';
 import { registerArchivePage } from './archive-page.js';
+import { registerClearPageContent } from './clear-page-content.js';
 import { registerCreateComment } from './create-comment.js';
 import { registerCreateCommentSimple } from './create-comment-simple.js';
 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 { registerDeleteBlocksBatch } from './delete-blocks-batch.js';
 import { registerFindAndReplaceInPage } from './find-and-replace-in-page.js';
 import { registerGetBlockChildren } from './get-block-children.js';
 import { registerListComments } from './list-comments.js';
@@ -31,5 +33,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, registerReplacePageContent, registerFindAndReplaceInPage, 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, registerDeleteBlocksBatch, registerClearPageContent, 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,4BAA4B,EAAE,MAAM,+BAA+B,CAAA;AAC5E,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,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AACtE,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"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"}

package/dist/src/tools/index.js

@@ -2,12 +2,14 @@ import { registerAppendBlockChildren } from './append-block-children.js';
 import { registerAppendBlocksSimple } from './append-blocks-simple.js';
 import { registerArchiveDatabase } from './archive-database.js';
 import { registerArchivePage } from './archive-page.js';
+import { registerClearPageContent } from './clear-page-content.js';
 import { registerCreateComment } from './create-comment.js';
 import { registerCreateCommentSimple } from './create-comment-simple.js';
 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 { registerDeleteBlocksBatch } from './delete-blocks-batch.js';
 import { registerFindAndReplaceInPage } from './find-and-replace-in-page.js';
 import { registerGetBlockChildren } from './get-block-children.js';
 import { registerListComments } from './list-comments.js';
@@ -56,6 +58,8 @@ export function registerAllTools(server, notion) {
     registerUpdateBlock(server, notion);
     registerUpdateBlockSimple(server, notion);
     registerDeleteBlock(server, notion);
+    registerDeleteBlocksBatch(server, notion);
+    registerClearPageContent(server, notion);
     registerReplacePageContent(server, notion);
     registerFindAndReplaceInPage(server, notion);
     // Comment operations
@@ -67,4 +71,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, registerReplacePageContent, registerFindAndReplaceInPage, 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, registerDeleteBlocksBatch, registerClearPageContent, registerReplacePageContent, registerFindAndReplaceInPage, registerCreateComment, registerCreateCommentSimple, registerListComments, registerListUsers, registerRetrieveUser, registerRetrieveBotUser, };

package/package.json

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