@atikk-co-jp/notion-mcp-server 0.8.1 → 0.9.1

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

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 import { parseInlineMarkdown } from '../converters/index.js';
 import { F } from '../schemas/descriptions/index.js';
-import { formatResponse, handleError } from '../utils/index.js';
+import { formatSimpleResponse, handleError } from '../utils/index.js';
 const inputSchema = {
     page_id: z.string().optional().describe(F.page_id),
     block_id: z.string().optional().describe(F.block_id),
@@ -10,7 +10,7 @@ const inputSchema = {
 };
 export function registerCreateCommentSimple(server, notion) {
     server.registerTool('create-comment-simple', {
-        description: 'Add a comment using Markdown. Simpler than create-comment.',
+        description: 'Add a comment using Markdown. Simpler than create-comment. Returns comment ID.',
         inputSchema,
     }, async ({ page_id, block_id, discussion_id, content }) => {
         try {
@@ -42,7 +42,10 @@ export function registerCreateCommentSimple(server, notion) {
                 params.parent = { block_id };
             }
             const response = await notion.comments.create(params);
-            return formatResponse(response);
+            // Return minimal response (id only)
+            return formatSimpleResponse({
+                id: response.id,
+            });
         }
         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;AAYvD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAuDnF"}
+{"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;AAYvD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA2DnF"}

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

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { F } from '../schemas/descriptions/index.js';
-import { formatResponse, handleErrorWithContext } from '../utils/index.js';
+import { formatSimpleResponse, handleErrorWithContext } from '../utils/index.js';
 // Minimal schema for MCP (full validation by Notion API)
 const inputSchema = {
     page_id: z.string().optional().describe(F.page_id),
@@ -13,7 +13,7 @@ export function registerCreateComment(server, notion) {
         description: 'Add a comment to a Notion page. Creates a new discussion or adds to an existing one. ' +
             'Comments support rich text formatting (bold, italic, links, etc.). ' +
             'Use discussion_id to reply to an existing comment thread. ' +
-            'Returns the created comment with its ID.',
+            'Returns the created comment ID.',
         inputSchema,
     }, async ({ page_id, block_id, discussion_id, rich_text }) => {
         try {
@@ -44,7 +44,10 @@ export function registerCreateComment(server, notion) {
                 params.parent = { block_id };
             }
             const response = await notion.comments.create(params);
-            return formatResponse(response);
+            // Return minimal response (id only)
+            return formatSimpleResponse({
+                id: response.id,
+            });
         }
         catch (error) {
             return handleErrorWithContext(error, notion, {

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

@@ -1 +1 @@
-{"version":3,"file":"create-database.d.ts","sourceRoot":"","sources":["../../../src/tools/create-database.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAevD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA+BpF"}
+{"version":3,"file":"create-database.d.ts","sourceRoot":"","sources":["../../../src/tools/create-database.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAevD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAqCpF"}

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

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { F } from '../schemas/descriptions/index.js';
-import { formatResponse, handleErrorWithContext } from '../utils/index.js';
+import { formatSimpleResponse, handleErrorWithContext } from '../utils/index.js';
 // Minimal schema for MCP (full validation by Notion API)
 // Uses z.any() for title/icon/cover to reduce context size (~2,300 tokens saved)
 const inputSchema = {
@@ -15,7 +15,8 @@ export function registerCreateDatabase(server, notion) {
     server.registerTool('create-database', {
         description: 'Create a new database as a subpage of an existing Notion page. ' +
             'Requires a parent_page_id and properties object defining the database schema. ' +
-            'Each database must have exactly one title property. (API version 2025-09-03)',
+            'Each database must have exactly one title property. ' +
+            'Returns database ID and URL. (API version 2025-09-03)',
         inputSchema,
     }, async ({ parent_page_id, title, properties, icon, cover, is_inline }) => {
         try {
@@ -29,7 +30,11 @@ export function registerCreateDatabase(server, notion) {
                 ...(is_inline !== undefined && { is_inline }),
             };
             const response = await notion.databases.create(params);
-            return formatResponse(response);
+            // Return minimal response (id + url only)
+            return formatSimpleResponse({
+                id: response.id,
+                url: 'url' in response ? response.url : undefined,
+            });
         }
         catch (error) {
             return handleErrorWithContext(error, notion, {

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

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

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

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

package/dist/src/tools/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;AAoBvD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA6ChF"}
+{"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,CAkDhF"}

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

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { F } from '../schemas/descriptions/index.js';
-import { formatResponse, handleErrorWithContext } from '../utils/index.js';
+import { formatSimpleResponse, handleErrorWithContext } from '../utils/index.js';
 // Minimal schema for MCP (full validation by Notion API)
 const inputSchema = {
     data_source_id: z.string().describe(F.data_source_id),
@@ -13,7 +13,7 @@ export function registerCreatePage(server, notion) {
     server.registerTool('create-page', {
         description: 'Create a new page in a Notion data source. Requires a data_source_id and properties object. ' +
             'Optionally include initial content blocks, icon, and cover image. ' +
-            'Returns the created page with its ID and URL. (API version 2025-09-03)',
+            'Returns the created page ID and URL. (API version 2025-09-03)',
         inputSchema,
     }, async ({ data_source_id, properties, children, icon, cover }) => {
         try {
@@ -31,7 +31,11 @@ export function registerCreatePage(server, notion) {
                 params.cover = cover;
             }
             const response = await notion.pages.create(params);
-            return formatResponse(response);
+            // Return minimal response (id + url only)
+            return formatSimpleResponse({
+                id: response.id,
+                url: 'url' in response ? response.url : undefined,
+            });
         }
         catch (error) {
             return handleErrorWithContext(error, notion, {

package/dist/src/tools/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;AAQvD,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,CAsBjF"}

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

@@ -1,18 +1,21 @@
 import { z } from 'zod';
 import { F } from '../schemas/descriptions/index.js';
-import { formatResponse, handleError } from '../utils/index.js';
+import { formatSimpleResponse, handleError } from '../utils/index.js';
 const inputSchema = {
     block_id: z.string().describe(F.block_id),
 };
 export function registerDeleteBlock(server, notion) {
     server.registerTool('delete-block', {
         description: 'Delete a block by its ID. The block will be archived (moved to trash). ' +
-            'Returns the archived block object.',
+            'Returns deleted block ID.',
         inputSchema,
     }, async ({ block_id }) => {
         try {
             const response = await notion.blocks.delete({ block_id });
-            return formatResponse(response);
+            // Return minimal response (id only)
+            return formatSimpleResponse({
+                id: response.id,
+            });
         }
         catch (error) {
             return handleError(error);

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;AAcvD,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,CA2C9E"}

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

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { F } from '../schemas/descriptions/index.js';
-import { formatResponse, handleError } from '../utils/index.js';
+import { formatSimpleResponse, handleError } from '../utils/index.js';
 const inputSchema = {
     page_id: z.string().describe(F.page_id),
     parent: z
@@ -14,7 +14,7 @@ export function registerMovePage(server, notion) {
     server.registerTool('move-page', {
         description: 'Move a page to a new parent (page or data source). ' +
             'Provide either page_id or data_source_id as the new parent. ' +
-            '(API version 2025-09-03)',
+            'Returns page ID and URL. (API version 2025-09-03)',
         inputSchema,
     }, async ({ page_id, parent }) => {
         try {
@@ -36,7 +36,11 @@ export function registerMovePage(server, notion) {
                 page_id,
                 parent: parentParam,
             });
-            return formatResponse(response);
+            // Return minimal response (id + url only)
+            return formatSimpleResponse({
+                id: response.id,
+                url: 'url' in response ? response.url : undefined,
+            });
         }
         catch (error) {
             return handleError(error);

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

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

@@ -11,15 +11,17 @@ const inputSchema = {
     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),
+    format: z.enum(['json', 'simple']).optional().default('simple').describe(F.format),
+    fields: z.array(z.string()).optional().describe(F.fields),
 };
 export function registerQueryDataSource(server, notion) {
     server.registerTool('query-data-source', {
         description: 'Query a Notion data source with optional filters and sorts. Returns paginated results. ' +
             "Use format='simple' (default) for human-readable output with reduced token usage. " +
+            'Use fields parameter to limit which properties are returned (simple format only). ' +
             '(API version 2025-09-03)',
         inputSchema,
-    }, async ({ data_source_id, filter, sorts, start_cursor, page_size, format }) => {
+    }, async ({ data_source_id, filter, sorts, start_cursor, page_size, format, fields }) => {
         try {
             const response = await notion.dataSources.query({
                 data_source_id,
@@ -31,9 +33,10 @@ export function registerQueryDataSource(server, notion) {
             if (format === 'simple') {
                 // Filter to full pages and cast for pagesToSimple converter
                 const fullPages = response.results.filter(isFullPage);
-                const simplePages = pagesToSimple(fullPages);
+                const simplePages = pagesToSimple(fullPages, fields);
                 return formatSimplePaginatedResponse(simplePages, response.has_more, response.next_cursor);
             }
+            // JSON format: full Notion API response
             return formatPaginatedResponse(response.results, response.has_more, response.next_cursor);
         }
         catch (error) {

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

@@ -4,7 +4,7 @@ import { F } from '../schemas/descriptions/index.js';
 import { formatResponse, formatSimpleResponse, handleError } from '../utils/index.js';
 const inputSchema = {
     data_source_id: z.string().describe(F.data_source_id),
-    format: z.enum(['json', 'simple']).optional().describe(F.format),
+    format: z.enum(['json', 'simple']).optional().default('simple').describe(F.format),
 };
 export function registerRetrieveDataSource(server, notion) {
     server.registerTool('retrieve-data-source', {
@@ -29,19 +29,19 @@ export function registerRetrieveDataSource(server, notion) {
                     id: prop.id,
                     type: prop.type,
                 };
-                // Include options for select/multi_select/status
+                // Include options for select/multi_select/status (names only for simple format)
                 const propAny = prop;
                 if (prop.type === 'select' && propAny.select) {
                     const selectProp = propAny.select;
-                    simpleProp.options = selectProp.options;
+                    simpleProp.options = selectProp.options?.map((o) => o.name);
                 }
                 else if (prop.type === 'multi_select' && propAny.multi_select) {
                     const multiSelectProp = propAny.multi_select;
-                    simpleProp.options = multiSelectProp.options;
+                    simpleProp.options = multiSelectProp.options?.map((o) => o.name);
                 }
                 else if (prop.type === 'status' && propAny.status) {
                     const statusProp = propAny.status;
-                    simpleProp.options = statusProp.options;
+                    simpleProp.options = statusProp.options?.map((o) => o.name);
                 }
                 simpleProperties[name] = simpleProp;
             }

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

@@ -4,7 +4,7 @@ import { F } from '../schemas/descriptions/index.js';
 import { formatResponse, formatSimpleResponse, handleError } from '../utils/index.js';
 const inputSchema = {
     database_id: z.string().describe(F.database_id),
-    format: z.enum(['json', 'simple']).optional().describe(F.format),
+    format: z.enum(['json', 'simple']).optional().default('simple').describe(F.format),
 };
 export function registerRetrieveDatabase(server, notion) {
     server.registerTool('retrieve-database', {

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

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

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/tools/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AA6BvD,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAmD5E"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/tools/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,EAAc,KAAK,YAAY,EAA2B,MAAM,qBAAqB,CAAA;AAmC5F,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAyF5E"}

package/dist/src/tools/search.js

@@ -1,6 +1,8 @@
 import { z } from 'zod';
+import { pagesToSimple } from '../converters/index.js';
+import { isFullPage } from '../notion-client.js';
 import { F } from '../schemas/descriptions/index.js';
-import { formatPaginatedResponse, handleErrorWithContext } from '../utils/index.js';
+import { formatPaginatedResponse, formatSimplePaginatedResponse, handleErrorWithContext, } from '../utils/index.js';
 const inputSchema = {
     query: z.string().optional().describe(F.query),
     filter: z
@@ -19,16 +21,20 @@ const inputSchema = {
         .describe(F.sort),
     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', 'simple']).optional().default('simple').describe(F.format),
+    fields: z.array(z.string()).optional().describe(F.fields),
 };
 export function registerSearch(server, notion) {
     server.registerTool('search', {
         description: 'Search across all pages and data sources in the workspace by title and content. ' +
             'Filter results by type (page or data_source) and sort by last edited time. ' +
             'Returns paginated results. ' +
+            "Use format='simple' (default) for human-readable output with reduced token usage. " +
+            'Use fields parameter to limit which properties are returned (simple format only). ' +
             'For querying a specific data source with filters, use query-data-source instead. ' +
             '(API version 2025-09-03)',
         inputSchema,
-    }, async ({ query, filter, sort, start_cursor, page_size }) => {
+    }, async ({ query, filter, sort, start_cursor, page_size, format, fields }) => {
         try {
             const params = {};
             if (query) {
@@ -47,6 +53,32 @@ export function registerSearch(server, notion) {
                 params.page_size = page_size;
             }
             const response = await notion.search(params);
+            if (format === 'simple') {
+                // Convert results to simple format
+                const simpleResults = response.results.map((result) => {
+                    if (result.object === 'page' && isFullPage(result)) {
+                        // Use pagesToSimple for pages
+                        const [simplePage] = pagesToSimple([result], fields);
+                        return { object: 'page', ...simplePage };
+                    }
+                    if (result.object === 'data_source') {
+                        // Simple format for data sources
+                        const ds = result;
+                        return {
+                            object: 'data_source',
+                            id: ds.id,
+                            title: ds.title?.map((t) => t.plain_text).join('') ?? '',
+                            url: ds.url ?? '',
+                        };
+                    }
+                    // Fallback for partial objects
+                    return {
+                        object: result.object,
+                        id: result.id,
+                    };
+                });
+                return formatSimplePaginatedResponse(simpleResults, response.has_more, response.next_cursor);
+            }
             return formatPaginatedResponse(response.results, response.has_more, response.next_cursor);
         }
         catch (error) {

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

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

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

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { parseInlineMarkdown } from '../converters/index.js';
 import { isFullBlock } from '../notion-client.js';
 import { F } from '../schemas/descriptions/index.js';
-import { formatResponse, handleError } from '../utils/index.js';
+import { formatSimpleResponse, handleError } from '../utils/index.js';
 const inputSchema = {
     block_id: z.string().describe(F.block_id),
     content: z.string().describe(F.content),
@@ -69,7 +69,10 @@ export function registerUpdateBlockSimple(server, notion) {
                 };
             }
             const response = await notion.blocks.update(params);
-            return formatResponse(response);
+            // Return minimal response (id only)
+            return formatSimpleResponse({
+                id: response.id,
+            });
         }
         catch (error) {
             return handleError(error);

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

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

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

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { F } from '../schemas/descriptions/index.js';
-import { formatResponse, handleErrorWithContext } from '../utils/index.js';
+import { formatSimpleResponse, handleErrorWithContext } from '../utils/index.js';
 const inputSchema = {
     block_id: z.string().describe(F.block_id),
     block: z.record(z.string(), z.any()).describe(F.block),
@@ -10,7 +10,8 @@ export function registerUpdateBlock(server, notion) {
     server.registerTool('update-block', {
         description: 'Update a block by its ID. Provide the block type and its properties. ' +
             'Example: { "paragraph": { "rich_text": [{ "text": { "content": "Updated text" } }] } }. ' +
-            'Set archived to true to move the block to trash.',
+            'Set archived to true to move the block to trash. ' +
+            'Returns updated block ID.',
         inputSchema,
     }, async ({ block_id, block, archived }) => {
         try {
@@ -22,7 +23,10 @@ export function registerUpdateBlock(server, notion) {
                 params.archived = archived;
             }
             const response = await notion.blocks.update(params);
-            return formatResponse(response);
+            // Return minimal response (id only)
+            return formatSimpleResponse({
+                id: response.id,
+            });
         }
         catch (error) {
             return handleErrorWithContext(error, notion, {

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

@@ -1 +1 @@
-{"version":3,"file":"update-data-source.d.ts","sourceRoot":"","sources":["../../../src/tools/update-data-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAcvD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA+BtF"}
+{"version":3,"file":"update-data-source.d.ts","sourceRoot":"","sources":["../../../src/tools/update-data-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAcvD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAmCtF"}

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

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { F } from '../schemas/descriptions/index.js';
-import { formatResponse, handleErrorWithContext } from '../utils/index.js';
+import { formatSimpleResponse, handleErrorWithContext } from '../utils/index.js';
 // Minimal schema for MCP (full validation by Notion API)
 const inputSchema = {
     data_source_id: z.string().describe(F.data_source_id),
@@ -10,7 +10,7 @@ export function registerUpdateDataSource(server, notion) {
     server.registerTool('update-data-source', {
         description: 'Update a data source schema (properties/columns). ' +
             'Use this to add, update, or delete properties. Set a property to null to delete it. ' +
-            '(API version 2025-09-03)',
+            'Returns data source ID. (API version 2025-09-03)',
         inputSchema,
     }, async ({ data_source_id, properties }) => {
         try {
@@ -19,7 +19,10 @@ export function registerUpdateDataSource(server, notion) {
                 params.properties = properties;
             }
             const response = await notion.dataSources.update(params);
-            return formatResponse(response);
+            // Return minimal response (id only)
+            return formatSimpleResponse({
+                id: response.id,
+            });
         }
         catch (error) {
             return handleErrorWithContext(error, notion, {

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

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

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

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { F } from '../schemas/descriptions/index.js';
-import { formatResponse, handleErrorWithContext } from '../utils/index.js';
+import { formatSimpleResponse, handleErrorWithContext } from '../utils/index.js';
 // Minimal schema for MCP (full validation by Notion API)
 // Note: Properties (schema) updates should use update-data-source in API 2025-09-03
 // Uses z.any() for title/description/icon/cover to reduce context size (~3,700 tokens saved)
@@ -17,7 +17,8 @@ const inputSchema = {
 export function registerUpdateDatabase(server, notion) {
     server.registerTool('update-database', {
         description: 'Update a Notion database container. Can modify title, description, icon, cover, inline status, archive status, and lock status. ' +
-            'For schema (properties/columns) updates, use update-data-source instead. (API version 2025-09-03)',
+            'For schema (properties/columns) updates, use update-data-source instead. ' +
+            'Returns database ID and URL. (API version 2025-09-03)',
         inputSchema,
     }, async ({ database_id, title, description, icon, cover, is_inline, archived, is_locked }) => {
         try {
@@ -33,7 +34,11 @@ export function registerUpdateDatabase(server, notion) {
                 ...(is_locked !== undefined && { is_locked }),
             };
             const response = await notion.databases.update(params);
-            return formatResponse(response);
+            // Return minimal response (id + url only)
+            return formatSimpleResponse({
+                id: response.id,
+                url: 'url' in response ? response.url : undefined,
+            });
         }
         catch (error) {
             return handleErrorWithContext(error, notion, {

package/dist/src/tools/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;AAoBvD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAsDhF"}
+{"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;AAoBvD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA4DhF"}

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

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { F } from '../schemas/descriptions/index.js';
-import { formatResponse, handleErrorWithContext } from '../utils/index.js';
+import { formatSimpleResponse, handleErrorWithContext } from '../utils/index.js';
 // Minimal schema for MCP (full validation by Notion API)
 const inputSchema = {
     page_id: z.string().describe(F.page_id),
@@ -16,7 +16,8 @@ export function registerUpdatePage(server, notion) {
             'Partial updates are supported - only provide the fields you want to change. ' +
             'Set icon or cover to null to remove them. ' +
             'Set archived to true to move the page to trash. ' +
-            'Set is_locked to true to lock the page in the UI.',
+            'Set is_locked to true to lock the page in the UI. ' +
+            'Returns updated page ID and URL.',
         inputSchema,
     }, async ({ page_id, properties, archived, icon, cover, is_locked }) => {
         try {
@@ -37,7 +38,11 @@ export function registerUpdatePage(server, notion) {
                 params.is_locked = is_locked;
             }
             const response = await notion.pages.update(params);
-            return formatResponse(response);
+            // Return minimal response (id + url only)
+            return formatSimpleResponse({
+                id: response.id,
+                url: 'url' in response ? response.url : undefined,
+            });
         }
         catch (error) {
             // Note: update-page uses page_id, not data_source_id,

package/package.json

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