@atikk-co-jp/notion-mcp-server 0.6.0 → 0.7.0

package/README.md

@@ -21,6 +21,8 @@ MCP (Model Context Protocol) server for Notion API. Enables AI assistants to int
 
 ## API Coverage
 
+> ⭐ = Markdown input supported (reduces input tokens by ~80%)
+
 | Category | Notion API | MCP Tool | Format |
 |----------|-----------|----------|--------|
 | **Pages** | | | |
@@ -50,6 +52,7 @@ MCP (Model Context Protocol) server for Notion API. Enables AI assistants to int
 | | | `append-blocks-simple` ⭐ | Markdown |
 | **Comments** | | | |
 | | [Create comment](https://developers.notion.com/reference/create-a-comment) | `create-comment` | JSON |
+| | | `create-comment-simple` ⭐ | Markdown |
 | | [List comments](https://developers.notion.com/reference/retrieve-comments) | `list-comments` | JSON |
 | **Users** | | | |
 | | [List users](https://developers.notion.com/reference/get-users) | `list-users` | JSON |
@@ -58,8 +61,6 @@ MCP (Model Context Protocol) server for Notion API. Enables AI assistants to int
 | **Search** | | | |
 | | [Search](https://developers.notion.com/reference/post-search) | `search` | JSON |
 
-⭐ = Markdown input supported (reduces input tokens by ~80%)
-
 ## Installation
 
 ```bash
@@ -414,6 +415,22 @@ Add a comment to a page.
 }
 ```
 
+### create-comment-simple ⭐
+
+Add a comment using Markdown. Simpler than `create-comment`.
+
+**Parameters:**
+- `page_id` (required): The ID of the page
+- `content` (required): Comment in Markdown
+- `discussion_id` (optional): Reply to existing thread
+
+```json
+{
+  "page_id": "page-uuid-here",
+  "content": "This is **important** with a [link](https://example.com)"
+}
+```
+
 ## Development
 
 ```bash

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

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

package/dist/src/tools/archive-database.js

@@ -5,8 +5,7 @@ const inputSchema = {
 };
 export function registerArchiveDatabase(server, notion) {
     server.registerTool('archive-database', {
-        description: 'Archive (delete) a Notion database by moving it to trash. ' +
-            'This is equivalent to update-database with archived: true.',
+        description: 'Move a database to trash. Recoverable for 30 days via Notion UI.',
         inputSchema,
     }, async ({ database_id }) => {
         try {

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;AAOvD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAqBjF"}
+{"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;AAOvD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAoBjF"}

package/dist/src/tools/archive-page.js

@@ -5,8 +5,7 @@ const inputSchema = {
 };
 export function registerArchivePage(server, notion) {
     server.registerTool('archive-page', {
-        description: 'Archive (delete) a Notion page by moving it to trash. ' +
-            'This is equivalent to update-page with archived: true.',
+        description: 'Move a page to trash. Recoverable for 30 days via Notion UI.',
         inputSchema,
     }, async ({ page_id }) => {
         try {

package/dist/src/tools/create-comment-simple.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 registerCreateCommentSimple(server: McpServer, notion: NotionClient): void;
+//# sourceMappingURL=create-comment-simple.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-comment-simple.d.ts","sourceRoot":"","sources":["../../../src/tools/create-comment-simple.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAUvD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAmDzF"}

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

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+import { parseInlineMarkdown } from '../converters/index.js';
+import { formatResponse, handleError } from '../utils/index.js';
+const inputSchema = {
+    page_id: z.string().optional().describe('Page ID (for page comments)'),
+    block_id: z.string().optional().describe('Block ID (for block comments)'),
+    discussion_id: z.string().optional().describe('Discussion ID (for replies)'),
+    content: z.string().describe('Comment in Markdown (**bold**, *italic*, [link](url), `code`)'),
+};
+export function registerCreateCommentSimple(server, notion) {
+    server.registerTool('create-comment-simple', {
+        description: 'Add a comment using Markdown. Simpler than create-comment.',
+        inputSchema,
+    }, async ({ page_id, block_id, discussion_id, content }) => {
+        try {
+            // Validate: exactly one of page_id, block_id, or discussion_id must be provided
+            const providedCount = [page_id, block_id, discussion_id].filter(Boolean).length;
+            if (providedCount !== 1) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Error: Provide exactly one of page_id, block_id, or discussion_id.',
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const rich_text = parseInlineMarkdown(content);
+            // Build params based on which ID was provided
+            const params = {
+                rich_text,
+            };
+            if (discussion_id) {
+                params.discussion_id = discussion_id;
+            }
+            else if (page_id) {
+                params.parent = { page_id };
+            }
+            else if (block_id) {
+                params.parent = { block_id };
+            }
+            const response = await notion.comments.create(params);
+            return formatResponse(response);
+        }
+        catch (error) {
+            return handleError(error);
+        }
+    });
+}

package/dist/src/tools/create-comment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-comment.d.ts","sourceRoot":"","sources":["../../../src/tools/create-comment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAUvD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAqCnF"}
+{"version":3,"file":"create-comment.d.ts","sourceRoot":"","sources":["../../../src/tools/create-comment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAWvD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAqDnF"}

package/dist/src/tools/create-comment.js

@@ -2,9 +2,10 @@ import { z } from 'zod';
 import { formatResponse, handleError } from '../utils/index.js';
 // Minimal schema for MCP (full validation by Notion API)
 const inputSchema = {
-    page_id: z.string().describe('Page ID'),
+    page_id: z.string().optional().describe('Page ID (for page comments)'),
+    block_id: z.string().optional().describe('Block ID (for block comments)'),
+    discussion_id: z.string().optional().describe('Discussion ID (for replies)'),
     rich_text: z.array(z.any()).describe('Comment content as rich text'),
-    discussion_id: z.string().optional().describe('Reply to existing discussion'),
 };
 export function registerCreateComment(server, notion) {
     server.registerTool('create-comment', {
@@ -13,18 +14,34 @@ export function registerCreateComment(server, notion) {
             'Use discussion_id to reply to an existing comment thread. ' +
             'Returns the created comment with its ID.',
         inputSchema,
-    }, async ({ page_id, rich_text, discussion_id }) => {
+    }, async ({ page_id, block_id, discussion_id, rich_text }) => {
         try {
-            // The Notion API requires either parent or discussion_id
+            // Validate: exactly one of page_id, block_id, or discussion_id must be provided
+            const providedCount = [page_id, block_id, discussion_id].filter(Boolean).length;
+            if (providedCount !== 1) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Error: Provide exactly one of page_id, block_id, or discussion_id.',
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // Build params based on which ID was provided
             const params = {
                 rich_text,
             };
             if (discussion_id) {
                 params.discussion_id = discussion_id;
             }
-            else {
+            else if (page_id) {
                 params.parent = { page_id };
             }
+            else if (block_id) {
+                params.parent = { block_id };
+            }
             const response = await notion.comments.create(params);
             return formatResponse(response);
         }

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;AAGxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAYvD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA4DtF"}
+{"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;AAGxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAqBvD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA+EtF"}

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

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { markdownToBlocks } from '../converters/index.js';
-import { formatResponse, handleError } from '../utils/index.js';
+import { formatResponse, handleErrorWithContext } from '../utils/index.js';
 // Minimal schema for MCP
 const inputSchema = {
     data_source_id: z.string().describe('Data source ID (required in API 2025-09-03)'),
@@ -11,13 +11,26 @@ const inputSchema = {
 };
 export function registerCreatePageSimple(server, notion) {
     server.registerTool('create-page-simple', {
-        description: 'Create a Notion page with Markdown content. ' +
-            'Simpler than create-page: just provide title and markdown text. ' +
-            'Supports: headings (#), lists (- or 1.), checkboxes (- [ ]), code blocks (```), quotes (>), images (![]()), bold (**), italic (*), links ([]()), etc. ' +
-            '(API version 2025-09-03)',
+        description: 'Create a page with Markdown. Title is auto-mapped to the database title property. ' +
+            'Supports: # headings, - lists, - [ ] checkboxes, ``` code, > quotes, **bold**, *italic*, [links]().',
         inputSchema,
     }, async ({ data_source_id, title, content, properties, icon }) => {
         try {
+            // Try to fetch data source schema to find the title property name
+            let titlePropertyName = 'Name'; // Default fallback
+            try {
+                const schema = await notion.dataSources.retrieve({
+                    data_source_id,
+                });
+                // Find the title property name from schema
+                const foundTitleProp = Object.entries(schema.properties).find(([, prop]) => prop.type === 'title');
+                if (foundTitleProp) {
+                    titlePropertyName = foundTitleProp[0];
+                }
+            }
+            catch {
+                // If schema fetch fails, fall back to 'Name'
+            }
             // Build properties with title
             const pageProperties = {
                 ...properties,
@@ -25,9 +38,9 @@ export function registerCreatePageSimple(server, notion) {
             // Check if any title property is already provided
             // Title properties have the structure: { title: [...] }
             const hasTitleProperty = Object.values(pageProperties).some((prop) => prop && typeof prop === 'object' && 'title' in prop);
-            // Only add Name if no title property exists
+            // Add title property if not already provided
             if (!hasTitleProperty) {
-                pageProperties.Name = {
+                pageProperties[titlePropertyName] = {
                     title: [{ type: 'text', text: { content: title } }],
                 };
             }
@@ -49,7 +62,10 @@ export function registerCreatePageSimple(server, notion) {
             return formatResponse(response);
         }
         catch (error) {
-            return handleError(error);
+            return handleErrorWithContext(error, notion, data_source_id, {
+                hint: 'Hint: The "title" parameter automatically sets the title property. ' +
+                    'Use "properties" for other fields like select or multi_select.',
+            });
         }
     });
 }

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

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { formatResponse, handleError } from '../utils/index.js';
+import { formatResponse, handleErrorWithContext } from '../utils/index.js';
 // Minimal schema for MCP (full validation by Notion API)
 const inputSchema = {
     data_source_id: z.string().describe('Data source ID (required in API 2025-09-03)'),
@@ -33,7 +33,7 @@ export function registerCreatePage(server, notion) {
             return formatResponse(response);
         }
         catch (error) {
-            return handleError(error);
+            return handleErrorWithContext(error, notion, data_source_id);
         }
     });
 }

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

@@ -22,7 +22,7 @@ const inputSchema = {
         .boolean()
         .optional()
         .default(false)
-        .describe("When format='markdown', fetch nested children blocks recursively (toggle, list items with children, etc.). Default is false."),
+        .describe('Fetch nested children recursively. Default false. WARNING: causes many API calls for deep structures.'),
 };
 export function registerGetBlockChildren(server, notion) {
     server.registerTool('get-block-children', {

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

@@ -5,6 +5,7 @@ import { registerAppendBlocksSimple } from './append-blocks-simple.js';
 import { registerArchiveDatabase } from './archive-database.js';
 import { registerArchivePage } from './archive-page.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';
@@ -28,5 +29,5 @@ import { registerUpdateDatabase } from './update-database.js';
 import { registerUpdateDataSource } from './update-data-source.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, 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, 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,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,wBAAwB,EAAE,MAAM,wBAAwB,CAAA;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AACtE,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,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAErD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAyC9E;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,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,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,wBAAwB,EAAE,MAAM,wBAAwB,CAAA;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AACtE,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,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAClE,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"}

package/dist/src/tools/index.js

@@ -3,6 +3,7 @@ import { registerAppendBlocksSimple } from './append-blocks-simple.js';
 import { registerArchiveDatabase } from './archive-database.js';
 import { registerArchivePage } from './archive-page.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';
@@ -55,10 +56,11 @@ export function registerAllTools(server, notion) {
     registerDeleteBlock(server, notion);
     // Comment operations
     registerCreateComment(server, notion);
+    registerCreateCommentSimple(server, notion);
     registerListComments(server, notion);
     // User operations
     registerListUsers(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, 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, registerCreateComment, registerCreateCommentSimple, registerListComments, registerListUsers, registerRetrieveUser, registerRetrieveBotUser, };

package/dist/src/tools/query-data-source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-data-source.d.ts","sourceRoot":"","sources":["../../../src/tools/query-data-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AA8BvD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAsDrF"}
+{"version":3,"file":"query-data-source.d.ts","sourceRoot":"","sources":["../../../src/tools/query-data-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAoCvD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAsDrF"}

package/dist/src/tools/query-data-source.js

@@ -4,8 +4,14 @@ import { formatPaginatedResponse, formatSimplePaginatedResponse, handleError, }
 // Minimal schema for MCP (full validation by Notion API)
 const inputSchema = {
     data_source_id: z.string().describe('Data source ID'),
-    filter: z.any().optional().describe('Filter conditions'),
-    sorts: z.array(z.any()).optional().describe('Sort conditions'),
+    filter: z
+        .any()
+        .optional()
+        .describe('Filter object. Example: {"property":"Status","select":{"equals":"Done"}}'),
+    sorts: z
+        .array(z.any())
+        .optional()
+        .describe('Sort array. Example: [{"property":"Date","direction":"descending"}]'),
     start_cursor: z.string().optional().describe('Pagination cursor'),
     page_size: z.number().optional().describe('Results per page (1-100)'),
     format: z.enum(['json', 'simple']).optional().describe('Output format (default: simple)'),

package/dist/src/tools/retrieve-page-property.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retrieve-page-property.d.ts","sourceRoot":"","sources":["../../../src/tools/retrieve-page-property.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAmBvD,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAkC1F"}
+{"version":3,"file":"retrieve-page-property.d.ts","sourceRoot":"","sources":["../../../src/tools/retrieve-page-property.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAmBvD,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAiC1F"}

package/dist/src/tools/retrieve-page-property.js

@@ -8,8 +8,7 @@ const inputSchema = {
 };
 export function registerRetrievePageProperty(server, notion) {
     server.registerTool('retrieve-page-property', {
-        description: 'Retrieve a specific property value from a page. Supports pagination for properties with many values (e.g., rollup, relation). ' +
-            'Use the property_id from the page properties object.',
+        description: 'Get a property with pagination (for relation/rollup with many items). For simple properties, use retrieve-page instead.',
         inputSchema,
     }, async ({ page_id, property_id, start_cursor, page_size }) => {
         try {

package/dist/src/tools/update-data-source.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { formatResponse, handleError } from '../utils/index.js';
+import { formatResponse, handleErrorWithContext } from '../utils/index.js';
 // Minimal schema for MCP (full validation by Notion API)
 const inputSchema = {
     data_source_id: z.string().describe('Data source ID'),
@@ -25,7 +25,7 @@ export function registerUpdateDataSource(server, notion) {
             return formatResponse(response);
         }
         catch (error) {
-            return handleError(error);
+            return handleErrorWithContext(error, notion, data_source_id);
         }
     });
 }

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

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

package/dist/src/tools/update-page.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { formatResponse, handleError } from '../utils/index.js';
+import { formatResponse, handleErrorWithContext } from '../utils/index.js';
 // Minimal schema for MCP (full validation by Notion API)
 const inputSchema = {
     page_id: z.string().describe('Page ID'),
@@ -39,7 +39,9 @@ export function registerUpdatePage(server, notion) {
             return formatResponse(response);
         }
         catch (error) {
-            return handleError(error);
+            // Note: update-page uses page_id, not data_source_id,
+            // so we can't show available properties without additional API call
+            return handleErrorWithContext(error, notion);
         }
     });
 }

package/dist/src/utils/error-handler.d.ts

@@ -1,3 +1,4 @@
+import type { NotionClient } from '../notion-client.js';
 export interface McpTextContent {
     type: 'text';
     text: string;
@@ -8,4 +9,14 @@ export interface McpResponse {
     isError?: boolean;
 }
 export declare function handleError(error: unknown): McpResponse;
+interface HandleErrorOptions {
+    /** Additional hint to append after property list (e.g., usage examples) */
+    hint?: string;
+}
+/**
+ * Enhanced error handler that includes available properties for validation errors.
+ * Use this for tools that operate on data sources (create-page, update-page, etc.)
+ */
+export declare function handleErrorWithContext(error: unknown, notion: NotionClient, dataSourceId?: string, options?: HandleErrorOptions): Promise<McpResponse>;
+export {};
 //# sourceMappingURL=error-handler.d.ts.map

package/dist/src/utils/error-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IACtB,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAaD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAoBvD"}
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IACtB,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAkBD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAoBvD;AA2DD,UAAU,kBAAkB;IAC1B,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,YAAY,EACpB,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAsBtB"}

package/dist/src/utils/error-handler.js

@@ -62,3 +62,39 @@ function formatNotionError(error) {
             return error.message;
     }
 }
+function isValidationError(error) {
+    if (!(error instanceof Error))
+        return false;
+    // Check if error message contains validation_error code
+    return error.message.includes('validation_error');
+}
+function formatPropertyList(properties) {
+    return Object.entries(properties)
+        .map(([name, prop]) => `  - ${name} (${prop.type})`)
+        .join('\n');
+}
+/**
+ * Enhanced error handler that includes available properties for validation errors.
+ * Use this for tools that operate on data sources (create-page, update-page, etc.)
+ */
+export async function handleErrorWithContext(error, notion, dataSourceId, options) {
+    const baseResponse = handleError(error);
+    // For validation errors with a data source ID, append available properties
+    if (isValidationError(error) && dataSourceId) {
+        try {
+            const schema = await notion.dataSources.retrieve({
+                data_source_id: dataSourceId,
+            });
+            const propList = formatPropertyList(schema.properties);
+            baseResponse.content[0].text += `\n\nAvailable properties:\n${propList}`;
+            // Add optional hint
+            if (options?.hint) {
+                baseResponse.content[0].text += `\n\n${options.hint}`;
+            }
+        }
+        catch {
+            // Ignore schema fetch errors - keep the original error message
+        }
+    }
+    return baseResponse;
+}

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

@@ -1,3 +1,3 @@
-export { handleError, type McpResponse, type McpTextContent } from './error-handler.js';
+export { handleError, handleErrorWithContext, type McpResponse, type McpTextContent } from './error-handler.js';
 export { formatMarkdownResponse, formatPaginatedResponse, formatResponse, formatSimplePaginatedResponse, formatSimpleResponse, formatSuccessMessage, } from './response-formatter.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACvF,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,cAAc,EACd,6BAA6B,EAC7B,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,yBAAyB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAC/G,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,cAAc,EACd,6BAA6B,EAC7B,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,yBAAyB,CAAA"}

package/dist/src/utils/index.js

@@ -1,2 +1,2 @@
-export { handleError } from './error-handler.js';
+export { handleError, handleErrorWithContext } from './error-handler.js';
 export { formatMarkdownResponse, formatPaginatedResponse, formatResponse, formatSimplePaginatedResponse, formatSimpleResponse, formatSuccessMessage, } from './response-formatter.js';

package/package.json

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