@atikk-co-jp/notion-mcp-server 0.2.3 → 0.4.0

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

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+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)'),
+};
+export function registerListComments(server, notion) {
+    server.registerTool('list-comments', {
+        description: 'List comments on a page or block. Either block_id or page_id must be provided. ' +
+            'Returns a paginated list of comments with their content and metadata.',
+        inputSchema,
+    }, async ({ block_id, page_id, start_cursor, page_size }) => {
+        try {
+            if (!block_id && !page_id) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Error: Either block_id or page_id must be provided.',
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // Notion API only accepts block_id (page_id works as block_id since pages are blocks)
+            const response = await notion.comments.list({
+                block_id: block_id || page_id,
+                start_cursor,
+                page_size,
+            });
+            // Format comments with essential info
+            const comments = response.results.map((comment) => ({
+                id: comment.id,
+                discussion_id: comment.discussion_id,
+                text: comment.rich_text.map((t) => t.plain_text).join(''),
+                created_time: comment.created_time,
+                created_by: comment.created_by.id,
+            }));
+            return formatPaginatedResponse(comments, response.has_more, response.next_cursor);
+        }
+        catch (error) {
+            return handleError(error);
+        }
+    });
+}

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

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

@@ -0,0 +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"}

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

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+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)'),
+};
+export function registerListUsers(server, notion) {
+    server.registerTool('list-users', {
+        description: 'List all users in the workspace. Returns paginated list of users with their IDs, names, and types (person or bot).',
+        inputSchema,
+    }, async ({ start_cursor, page_size }) => {
+        try {
+            const response = await notion.users.list({
+                start_cursor,
+                page_size,
+            });
+            // Format users with essential info
+            const users = response.results.map((user) => ({
+                id: user.id,
+                type: user.type,
+                name: user.name,
+                avatar_url: user.avatar_url,
+                email: user.person?.email,
+            }));
+            return formatPaginatedResponse(users, response.has_more, response.next_cursor);
+        }
+        catch (error) {
+            return handleError(error);
+        }
+    });
+}

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

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

@@ -0,0 +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,CAsC9E"}

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

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+import { formatResponse, handleError } from '../utils/index.js';
+const inputSchema = {
+    page_id: z.string().describe('Page ID to move'),
+    parent: z
+        .object({
+        page_id: z.string().optional().describe('Target parent page ID'),
+        database_id: z.string().optional().describe('Target database ID'),
+    })
+        .describe('New parent (provide either page_id or database_id)'),
+};
+export function registerMovePage(server, notion) {
+    server.registerTool('move-page', {
+        description: 'Move a page to a new parent (page or database). ' +
+            'Provide either page_id or database_id as the new parent.',
+        inputSchema,
+    }, async ({ page_id, parent }) => {
+        try {
+            if (!parent.page_id && !parent.database_id) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Error: Parent must have either page_id or database_id.',
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const parentParam = parent.page_id
+                ? { page_id: parent.page_id }
+                : { database_id: parent.database_id };
+            const response = await notion.pages.move({
+                page_id,
+                parent: parentParam,
+            });
+            return formatResponse(response);
+        }
+        catch (error) {
+            return handleError(error);
+        }
+    });
+}

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

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

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

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

@@ -0,0 +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"}

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

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+import { blocksToMarkdownSync } from '../converters/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'"),
+};
+export function registerRetrieveBlock(server, notion) {
+    server.registerTool('retrieve-block', {
+        description: 'Retrieve a single block by its ID. Returns block content and metadata. ' +
+            "Use format='markdown' (default) for human-readable output, 'json' for full Notion API response.",
+        inputSchema,
+    }, async ({ block_id, format = 'markdown' }) => {
+        try {
+            const response = await notion.blocks.retrieve({
+                block_id,
+            });
+            if (format === 'json') {
+                return formatResponse(response);
+            }
+            // Convert to markdown
+            const markdown = blocksToMarkdownSync([response]);
+            return formatMarkdownResponse(markdown, false, null);
+        }
+        catch (error) {
+            return handleError(error);
+        }
+    });
+}

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

package/dist/src/tools/retrieve-bot-user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve-bot-user.d.ts","sourceRoot":"","sources":["../../../src/tools/retrieve-bot-user.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAGvD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAkBrF"}

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

@@ -0,0 +1,16 @@
+import { formatResponse, handleError } from '../utils/index.js';
+export function registerRetrieveBotUser(server, notion) {
+    server.registerTool('retrieve-bot-user', {
+        description: 'Retrieve information about the current bot user (the integration). ' +
+            'Returns the bot ID, name, avatar, and owner information.',
+        inputSchema: {},
+    }, async () => {
+        try {
+            const response = await notion.users.me();
+            return formatResponse(response);
+        }
+        catch (error) {
+            return handleError(error);
+        }
+    });
+}

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

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

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

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

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+import { formatResponse, formatSimpleResponse, handleError } from '../utils/index.js';
+const inputSchema = {
+    database_id: z.string().describe('Database ID'),
+    format: z
+        .enum(['json', 'simple'])
+        .optional()
+        .describe("Output format: 'simple' (default) or 'json'"),
+};
+export function registerRetrieveDatabase(server, notion) {
+    server.registerTool('retrieve-database', {
+        description: 'Retrieve a database schema by its ID. Returns database properties (columns) and their types. ' +
+            "Use format='simple' (default) for reduced token usage, 'json' for full Notion API response.",
+        inputSchema,
+    }, async ({ database_id, format = 'simple' }) => {
+        try {
+            const response = await notion.databases.retrieve({ database_id });
+            if (format === 'json') {
+                return formatResponse(response);
+            }
+            // Simple format: extract essential info
+            const simpleProperties = {};
+            for (const [name, prop] of Object.entries(response.properties)) {
+                const simpleProp = {
+                    id: prop.id,
+                    type: prop.type,
+                };
+                // Include options for select/multi_select/status
+                if (prop.type === 'select' && prop.select) {
+                    const selectProp = prop.select;
+                    simpleProp.options = selectProp.options;
+                }
+                else if (prop.type === 'multi_select' && prop.multi_select) {
+                    const multiSelectProp = prop.multi_select;
+                    simpleProp.options = multiSelectProp.options;
+                }
+                else if (prop.type === 'status' && prop.status) {
+                    const statusProp = prop.status;
+                    simpleProp.options = statusProp.options;
+                }
+                simpleProperties[name] = simpleProp;
+            }
+            const simpleResponse = {
+                id: response.id,
+                title: response.title.map((t) => t.plain_text).join(''),
+                description: response.description.map((t) => t.plain_text).join(''),
+                url: response.url,
+                properties: simpleProperties,
+                is_inline: response.is_inline,
+                archived: response.archived,
+            };
+            return formatSimpleResponse(simpleResponse);
+        }
+        catch (error) {
+            return handleError(error);
+        }
+    });
+}

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

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

@@ -0,0 +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"}

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

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import { formatPaginatedResponse, formatResponse, handleError } from '../utils/index.js';
+const inputSchema = {
+    page_id: z.string().describe('Page ID'),
+    property_id: z.string().describe('Property ID (from page properties)'),
+    start_cursor: z.string().optional().describe('Pagination cursor'),
+    page_size: z.number().optional().describe('Number of results (1-100)'),
+};
+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.',
+        inputSchema,
+    }, async ({ page_id, property_id, start_cursor, page_size }) => {
+        try {
+            const response = await notion.pages.retrieveProperty({
+                page_id,
+                property_id,
+                start_cursor,
+                page_size,
+            });
+            // If it's a paginated list response
+            if (response.object === 'list' && response.results) {
+                return formatPaginatedResponse(response.results, response.has_more ?? false, response.next_cursor ?? null);
+            }
+            // Single property item
+            return formatResponse(response);
+        }
+        catch (error) {
+            return handleError(error);
+        }
+    });
+}

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

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

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

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

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import { formatResponse, handleError } from '../utils/index.js';
+const inputSchema = {
+    user_id: z.string().describe('User ID'),
+};
+export function registerRetrieveUser(server, notion) {
+    server.registerTool('retrieve-user', {
+        description: 'Retrieve a user by their ID. Returns user information including name, avatar, and type (person or bot).',
+        inputSchema,
+    }, async ({ user_id }) => {
+        try {
+            const response = await notion.users.retrieve({ user_id });
+            return formatResponse(response);
+        }
+        catch (error) {
+            return handleError(error);
+        }
+    });
+}

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

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

@@ -0,0 +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,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAwBvD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA2DvF"}

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

@@ -0,0 +1,68 @@
+import { z } from 'zod';
+import { parseInlineMarkdown } from '../converters/index.js';
+import { formatResponse, handleError } from '../utils/index.js';
+const inputSchema = {
+    block_id: z.string().describe('Block ID to update'),
+    content: z.string().describe('New content in Markdown format'),
+};
+// Supported block types for simple update
+const SUPPORTED_TYPES = [
+    'paragraph',
+    'heading_1',
+    'heading_2',
+    'heading_3',
+    'bulleted_list_item',
+    'numbered_list_item',
+    'to_do',
+    'quote',
+    'callout',
+    'toggle',
+];
+export function registerUpdateBlockSimple(server, notion) {
+    server.registerTool('update-block-simple', {
+        description: 'Update a text block using Markdown. Simpler than update-block: just provide markdown text. ' +
+            'Supports inline formatting: **bold**, *italic*, ~~strikethrough~~, `code`, [links](url). ' +
+            'Only works with text-based blocks: paragraph, headings, lists, to_do, quote, callout, toggle.',
+        inputSchema,
+    }, async ({ block_id, content }) => {
+        try {
+            // First, retrieve the block to get its type
+            const existingBlock = await notion.blocks.retrieve({ block_id });
+            const blockType = existingBlock.type;
+            if (!SUPPORTED_TYPES.includes(blockType)) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error: Block type "${blockType}" is not supported for simple update. Supported types: ${SUPPORTED_TYPES.join(', ')}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // Parse markdown to rich_text
+            const richText = parseInlineMarkdown(content);
+            // Build the update params based on block type
+            const params = {
+                block_id,
+            };
+            if (blockType === 'to_do') {
+                // Preserve the checked state for to_do blocks
+                params[blockType] = {
+                    rich_text: richText,
+                    checked: existingBlock.to_do?.checked ?? false,
+                };
+            }
+            else {
+                params[blockType] = {
+                    rich_text: richText,
+                };
+            }
+            const response = await notion.blocks.update(params);
+            return formatResponse(response);
+        }
+        catch (error) {
+            return handleError(error);
+        }
+    });
+}

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

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

@@ -0,0 +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;AASvD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA4BjF"}

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

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import { formatResponse, handleError } from '../utils/index.js';
+const inputSchema = {
+    block_id: z.string().describe('Block ID to update'),
+    block: z.record(z.string(), z.any()).describe('Block data with type-specific properties'),
+    archived: z.boolean().optional().describe('Set to true to archive the block'),
+};
+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.',
+        inputSchema,
+    }, async ({ block_id, block, archived }) => {
+        try {
+            const params = {
+                block_id,
+                ...block,
+            };
+            if (archived !== undefined) {
+                params.archived = archived;
+            }
+            const response = await notion.blocks.update(params);
+            return formatResponse(response);
+        }
+        catch (error) {
+            return handleError(error);
+        }
+    });
+}

package/package.json

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