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

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;AAIxE,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAiBzE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAqEtF"}

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

@@ -1,23 +1,38 @@
 import { z } from 'zod';
 import { markdownToBlocks } from '../converters/index.js';
-import { formatResponse, handleError } from '../utils/index.js';
+import { isFullDataSource } from '../notion-client.js';
+import { F } from '../schemas/descriptions/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)'),
-    title: z.string().describe('Page title'),
-    content: z.string().optional().describe('Page content in Markdown'),
-    properties: z.record(z.string(), z.any()).optional().describe('Additional properties'),
-    icon: z.string().optional().describe('Emoji character (e.g. "📝", "🐛", "✅"). Must be an actual emoji, not a name.'),
+    data_source_id: z.string().describe(F.data_source_id),
+    title: z.string().describe(F.title),
+    content: z.string().optional().describe(F.content),
+    properties: z.record(z.string(), z.any()).optional().describe(F.properties),
+    icon: z.string().optional().describe(F.icon_emoji),
 };
 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, | tables |, **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 });
+                if (isFullDataSource(schema)) {
+                    // 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,31 +40,31 @@ 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 } }],
                 };
             }
-            // Build params
-            const params = {
+            // Cast markdownToBlocks output to SDK's BlockObjectRequest type
+            const children = content
+                ? markdownToBlocks(content)
+                : undefined;
+            const response = await notion.pages.create({
                 parent: { data_source_id },
                 properties: pageProperties,
-            };
-            // Convert markdown to blocks if content provided
-            if (content) {
-                params.children = markdownToBlocks(content);
-            }
-            // Add icon if provided
-            if (icon) {
-                params.icon = { type: 'emoji', emoji: icon };
-            }
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            const response = await notion.pages.create(params);
+                ...(children && { children }),
+                ...(icon && { icon: { type: 'emoji', emoji: icon } }),
+            });
             return formatResponse(response);
         }
         catch (error) {
-            return handleError(error);
+            return handleErrorWithContext(error, notion, {
+                dataSourceId: data_source_id,
+                exampleType: 'page',
+                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.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-page.d.ts","sourceRoot":"","sources":["../../../src/tools/create-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,CA0ChF"}
+{"version":3,"file":"create-page.d.ts","sourceRoot":"","sources":["../../../src/tools/create-page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAoBvD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA6ChF"}

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

@@ -1,12 +1,13 @@
 import { z } from 'zod';
-import { formatResponse, handleError } from '../utils/index.js';
+import { F } from '../schemas/descriptions/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)'),
-    properties: z.record(z.string(), z.any()).describe('Notion properties object'),
-    children: z.array(z.any()).optional().describe('Block objects array'),
-    icon: z.any().optional().describe('Page icon { type: "emoji", emoji: "📝" } or { type: "external", external: { url: "..." } }. Emoji must be an actual emoji character.'),
-    cover: z.any().optional().describe('Cover image'),
+    data_source_id: z.string().describe(F.data_source_id),
+    properties: z.record(z.string(), z.any()).describe(F.properties),
+    children: z.array(z.any()).optional().describe(F.children),
+    icon: z.any().optional().describe(F.icon),
+    cover: z.any().optional().describe(F.cover),
 };
 export function registerCreatePage(server, notion) {
     server.registerTool('create-page', {
@@ -33,7 +34,10 @@ export function registerCreatePage(server, notion) {
             return formatResponse(response);
         }
         catch (error) {
-            return handleError(error);
+            return handleErrorWithContext(error, notion, {
+                dataSourceId: data_source_id,
+                exampleType: 'page',
+            });
         }
     });
 }

package/dist/src/tools/delete-block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delete-block.d.ts","sourceRoot":"","sources":["../../../src/tools/delete-block.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,CAkBjF"}
+{"version":3,"file":"delete-block.d.ts","sourceRoot":"","sources":["../../../src/tools/delete-block.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,CAkBjF"}

package/dist/src/tools/delete-block.js

@@ -1,7 +1,8 @@
 import { z } from 'zod';
+import { F } from '../schemas/descriptions/index.js';
 import { formatResponse, handleError } from '../utils/index.js';
 const inputSchema = {
-    block_id: z.string().describe('Block ID to delete'),
+    block_id: z.string().describe(F.block_id),
 };
 export function registerDeleteBlock(server, notion) {
     server.registerTool('delete-block', {

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

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

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,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAqCvD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA2CtF"}
+{"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"}

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

@@ -1,28 +1,14 @@
 import { z } from 'zod';
 import { blocksToMarkdown, blocksToMarkdownSync } 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';
 const inputSchema = {
-    block_id: z.string().describe('The ID of the block or page to get children from'),
-    start_cursor: z
-        .string()
-        .optional()
-        .describe('Cursor for pagination. Use the next_cursor from previous response.'),
-    page_size: z
-        .number()
-        .min(1)
-        .max(100)
-        .optional()
-        .describe('Number of results to return (1-100). Default is 100.'),
-    format: z
-        .enum(['json', 'markdown'])
-        .optional()
-        .default('markdown')
-        .describe("Output format: 'markdown' (default) returns human-readable text with significantly reduced token usage, 'json' returns raw Notion API response"),
-    fetch_nested: z
-        .boolean()
-        .optional()
-        .default(false)
-        .describe("When format='markdown', fetch nested children blocks recursively (toggle, list items with children, etc.). Default is false."),
+    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),
+    fetch_nested: z.boolean().optional().default(false).describe(F.fetch_nested),
 };
 export function registerGetBlockChildren(server, notion) {
     server.registerTool('get-block-children', {
@@ -35,21 +21,21 @@ export function registerGetBlockChildren(server, notion) {
                 start_cursor,
                 page_size,
             });
+            // Filter to full blocks
+            const blocks = response.results.filter(isFullBlock);
             if (format === 'markdown') {
                 let markdown;
                 if (fetch_nested) {
                     // 子ブロックを再帰的に取得
                     const fetchChildren = async (blockId) => {
-                        const res = await notion.blocks.children.list({
-                            block_id: blockId,
-                        });
-                        return res.results;
+                        const res = await notion.blocks.children.list({ block_id: blockId });
+                        return res.results.filter(isFullBlock);
                     };
-                    markdown = await blocksToMarkdown(response.results, { fetchChildren });
+                    markdown = await blocksToMarkdown(blocks, { fetchChildren });
                 }
                 else {
                     // 子ブロック取得なし（同期版）
-                    markdown = blocksToMarkdownSync(response.results);
+                    markdown = blocksToMarkdownSync(blocks);
                 }
                 return formatMarkdownResponse(markdown, response.has_more, response.next_cursor);
             }

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';
@@ -16,17 +17,17 @@ import { registerMovePage } from './move-page.js';
 import { registerQueryDataSource } from './query-data-source.js';
 import { registerRetrieveBlock } from './retrieve-block.js';
 import { registerRetrieveBotUser } from './retrieve-bot-user.js';
-import { registerRetrieveDatabase } from './retrieve-database.js';
 import { registerRetrieveDataSource } from './retrieve-data-source.js';
+import { registerRetrieveDatabase } from './retrieve-database.js';
 import { registerRetrievePage } from './retrieve-page.js';
 import { registerRetrievePageProperty } from './retrieve-page-property.js';
 import { registerRetrieveUser } from './retrieve-user.js';
 import { registerSearch } from './search.js';
 import { registerUpdateBlock } from './update-block.js';
 import { registerUpdateBlockSimple } from './update-block-simple.js';
-import { registerUpdateDatabase } from './update-database.js';
 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, 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,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"}

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';
@@ -14,16 +15,16 @@ import { registerMovePage } from './move-page.js';
 import { registerQueryDataSource } from './query-data-source.js';
 import { registerRetrieveBlock } from './retrieve-block.js';
 import { registerRetrieveBotUser } from './retrieve-bot-user.js';
-import { registerRetrieveDatabase } from './retrieve-database.js';
 import { registerRetrieveDataSource } from './retrieve-data-source.js';
+import { registerRetrieveDatabase } from './retrieve-database.js';
 import { registerRetrievePage } from './retrieve-page.js';
 import { registerRetrievePageProperty } from './retrieve-page-property.js';
 import { registerRetrieveUser } from './retrieve-user.js';
 import { registerSearch } from './search.js';
 import { registerUpdateBlock } from './update-block.js';
 import { registerUpdateBlockSimple } from './update-block-simple.js';
-import { registerUpdateDatabase } from './update-database.js';
 import { registerUpdateDataSource } from './update-data-source.js';
+import { registerUpdateDatabase } from './update-database.js';
 import { registerUpdatePage } from './update-page.js';
 export function registerAllTools(server, notion) {
     // Page operations
@@ -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/list-comments.d.ts

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

package/dist/src/tools/list-comments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-comments.d.ts","sourceRoot":"","sources":["../../../src/tools/list-comments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AA6BvD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA6ClF"}
+{"version":3,"file":"list-comments.d.ts","sourceRoot":"","sources":["../../../src/tools/list-comments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAWtE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA+ClF"}

package/dist/src/tools/list-comments.js

@@ -1,13 +1,12 @@
 import { z } from 'zod';
+import { isFullComment } from '../notion-client.js';
+import { F } from '../schemas/descriptions/index.js';
 import { formatPaginatedResponse, handleError } from '../utils/index.js';
 const inputSchema = {
-    block_id: z.string().optional().describe('Block ID to get comments from'),
-    page_id: z
-        .string()
-        .optional()
-        .describe('Page ID to get comments from (use either block_id or page_id)'),
-    start_cursor: z.string().optional().describe('Pagination cursor'),
-    page_size: z.number().optional().describe('Number of results (1-100)'),
+    block_id: z.string().optional().describe(F.block_id),
+    page_id: z.string().optional().describe(F.page_id),
+    start_cursor: z.string().optional().describe(F.start_cursor),
+    page_size: z.number().optional().describe(F.page_size),
 };
 export function registerListComments(server, notion) {
     server.registerTool('list-comments', {
@@ -28,13 +27,15 @@ export function registerListComments(server, notion) {
                 };
             }
             // Notion API only accepts block_id (page_id works as block_id since pages are blocks)
+            // We checked above that at least one is defined, so we can safely use the fallback
+            const targetBlockId = block_id ?? page_id ?? '';
             const response = await notion.comments.list({
-                block_id: block_id || page_id,
+                block_id: targetBlockId,
                 start_cursor,
                 page_size,
             });
-            // Format comments with essential info
-            const comments = response.results.map((comment) => ({
+            // Format comments with essential info (filter to full comments only)
+            const comments = response.results.filter(isFullComment).map((comment) => ({
                 id: comment.id,
                 discussion_id: comment.discussion_id,
                 text: comment.rich_text.map((t) => t.plain_text).join(''),

package/dist/src/tools/list-users.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-users.d.ts","sourceRoot":"","sources":["../../../src/tools/list-users.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAuBvD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA8B/E"}
+{"version":3,"file":"list-users.d.ts","sourceRoot":"","sources":["../../../src/tools/list-users.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AASvD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA8B/E"}

package/dist/src/tools/list-users.js

@@ -1,8 +1,9 @@
 import { z } from 'zod';
+import { F } from '../schemas/descriptions/index.js';
 import { formatPaginatedResponse, handleError } from '../utils/index.js';
 const inputSchema = {
-    start_cursor: z.string().optional().describe('Pagination cursor'),
-    page_size: z.number().optional().describe('Number of results (1-100)'),
+    start_cursor: z.string().optional().describe(F.start_cursor),
+    page_size: z.number().optional().describe(F.page_size),
 };
 export function registerListUsers(server, notion) {
     server.registerTool('list-users', {
@@ -20,7 +21,7 @@ export function registerListUsers(server, notion) {
                 type: user.type,
                 name: user.name,
                 avatar_url: user.avatar_url,
-                email: user.person?.email,
+                email: user.type === 'person' ? user.person.email : undefined,
             }));
             return formatPaginatedResponse(users, response.has_more, response.next_cursor);
         }

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

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

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

@@ -1,13 +1,14 @@
 import { z } from 'zod';
+import { F } from '../schemas/descriptions/index.js';
 import { formatResponse, handleError } from '../utils/index.js';
 const inputSchema = {
-    page_id: z.string().describe('Page ID to move'),
+    page_id: z.string().describe(F.page_id),
     parent: z
         .object({
-        page_id: z.string().optional().describe('Target parent page ID'),
-        data_source_id: z.string().optional().describe('Target data source ID'),
+        page_id: z.string().optional().describe(F.page_id_target),
+        data_source_id: z.string().optional().describe(F.data_source_id_target),
     })
-        .describe('New parent (provide either page_id or data_source_id)'),
+        .describe(F.parent),
 };
 export function registerMovePage(server, notion) {
     server.registerTool('move-page', {

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

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

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,EAAc,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAmBnE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAqCrF"}

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

@@ -1,14 +1,17 @@
 import { z } from 'zod';
 import { pagesToSimple } from '../converters/index.js';
-import { formatPaginatedResponse, formatSimplePaginatedResponse, handleError, } from '../utils/index.js';
+import { isFullPage } from '../notion-client.js';
+import { F } from '../schemas/descriptions/index.js';
+import { formatPaginatedResponse, formatSimplePaginatedResponse, handleErrorWithContext, } from '../utils/index.js';
 // Minimal schema for MCP (full validation by Notion API)
+// Uses z.any() for filter/sorts to reduce context size (~8,000 tokens saved)
 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'),
-    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)'),
+    data_source_id: z.string().describe(F.data_source_id),
+    filter: z.any().optional().describe(F.filter),
+    sorts: z.array(z.any()).optional().describe(F.sorts),
+    start_cursor: z.string().optional().describe(F.start_cursor),
+    page_size: z.number().optional().describe(F.page_size),
+    format: z.enum(['json', 'simple']).optional().describe(F.format),
 };
 export function registerQueryDataSource(server, notion) {
     server.registerTool('query-data-source', {
@@ -18,29 +21,25 @@ export function registerQueryDataSource(server, notion) {
         inputSchema,
     }, async ({ data_source_id, filter, sorts, start_cursor, page_size, format }) => {
         try {
-            const params = { data_source_id };
-            if (filter) {
-                params.filter = filter;
-            }
-            if (sorts) {
-                params.sorts = sorts;
-            }
-            if (start_cursor) {
-                params.start_cursor = start_cursor;
-            }
-            if (page_size) {
-                params.page_size = page_size;
-            }
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            const response = await notion.dataSources.query(params);
+            const response = await notion.dataSources.query({
+                data_source_id,
+                ...(filter && { filter }),
+                ...(sorts && { sorts }),
+                ...(start_cursor && { start_cursor }),
+                ...(page_size && { page_size }),
+            });
             if (format === 'simple') {
-                const simplePages = pagesToSimple(response.results);
+                // Filter to full pages and cast for pagesToSimple converter
+                const fullPages = response.results.filter(isFullPage);
+                const simplePages = pagesToSimple(fullPages);
                 return formatSimplePaginatedResponse(simplePages, response.has_more, response.next_cursor);
             }
             return formatPaginatedResponse(response.results, response.has_more, response.next_cursor);
         }
         catch (error) {
-            return handleError(error);
+            return handleErrorWithContext(error, notion, {
+                exampleType: 'filter',
+            });
         }
     });
 }

package/dist/src/tools/retrieve-block.d.ts

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

package/dist/src/tools/retrieve-block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retrieve-block.d.ts","sourceRoot":"","sources":["../../../src/tools/retrieve-block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAWvD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA2BnF"}
+{"version":3,"file":"retrieve-block.d.ts","sourceRoot":"","sources":["../../../src/tools/retrieve-block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAA;AASpE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAgCnF"}

package/dist/src/tools/retrieve-block.js

@@ -1,12 +1,11 @@
 import { z } from 'zod';
 import { blocksToMarkdownSync } from '../converters/index.js';
+import { isFullBlock } from '../notion-client.js';
+import { F } from '../schemas/descriptions/index.js';
 import { formatMarkdownResponse, formatResponse, handleError } from '../utils/index.js';
 const inputSchema = {
-    block_id: z.string().describe('Block ID to retrieve'),
-    format: z
-        .enum(['markdown', 'json'])
-        .optional()
-        .describe("Output format: 'markdown' (default) or 'json'"),
+    block_id: z.string().describe(F.block_id),
+    format: z.enum(['markdown', 'json']).optional().describe(F.format),
 };
 export function registerRetrieveBlock(server, notion) {
     server.registerTool('retrieve-block', {
@@ -15,14 +14,18 @@ export function registerRetrieveBlock(server, notion) {
         inputSchema,
     }, async ({ block_id, format = 'markdown' }) => {
         try {
-            const response = await notion.blocks.retrieve({
-                block_id,
-            });
+            const response = await notion.blocks.retrieve({ block_id });
             if (format === 'json') {
                 return formatResponse(response);
             }
-            // Convert to markdown
-            const markdown = blocksToMarkdownSync([response]);
+            // Need full block for markdown conversion
+            if (!isFullBlock(response)) {
+                return formatResponse(response);
+            }
+            // Convert to markdown (cast to any for now until converters are updated)
+            const markdown = blocksToMarkdownSync([
+                response,
+            ]);
             return formatMarkdownResponse(markdown, false, null);
         }
         catch (error) {

package/dist/src/tools/retrieve-bot-user.js

@@ -6,7 +6,7 @@ export function registerRetrieveBotUser(server, notion) {
         inputSchema: {},
     }, async () => {
         try {
-            const response = await notion.users.me();
+            const response = await notion.users.me({});
             return formatResponse(response);
         }
         catch (error) {

package/dist/src/tools/retrieve-data-source.d.ts

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

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

@@ -1 +1 @@
-{"version":3,"file":"retrieve-data-source.d.ts","sourceRoot":"","sources":["../../../src/tools/retrieve-data-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AA2BvD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAwDxF"}
+{"version":3,"file":"retrieve-data-source.d.ts","sourceRoot":"","sources":["../../../src/tools/retrieve-data-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAezE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAkExF"}