@atikk-co-jp/notion-mcp-server 0.1.0

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

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

@@ -0,0 +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,CAAC;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAoBxD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA+BnF"}

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

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { formatResponse, handleError } from "../utils/index.js";
+const inputSchema = {
+    page_id: z.string().describe("The ID of the page to add a comment to"),
+    rich_text: z
+        .array(z.any())
+        .describe("The comment content as rich text. " +
+        'Example: [{ "type": "text", "text": { "content": "This is a comment" } }]'),
+    discussion_id: z
+        .string()
+        .optional()
+        .describe("Optional ID of an existing discussion to add the comment to. " +
+        "If not provided, a new discussion is created."),
+};
+export function registerCreateComment(server, notion) {
+    server.tool("create-comment", "Add a comment to a Notion page. Creates a new discussion or adds to an existing one.", inputSchema, async ({ page_id, rich_text, discussion_id }) => {
+        try {
+            // The Notion API requires either parent or discussion_id
+            const params = {
+                rich_text,
+            };
+            if (discussion_id) {
+                params.discussion_id = discussion_id;
+            }
+            else {
+                params.parent = { page_id };
+            }
+            const response = await notion.comments.create(params);
+            return formatResponse(response);
+        }
+        catch (error) {
+            return handleError(error);
+        }
+    });
+}

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

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

@@ -0,0 +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,CAAC;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAoCxD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAqChF"}

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

@@ -0,0 +1,50 @@
+import { z } from "zod";
+import { formatResponse, handleError } from "../utils/index.js";
+const inputSchema = {
+    database_id: z.string().describe("The ID of the database where the page will be created"),
+    properties: z
+        .record(z.string(), z.any())
+        .describe("Page properties as a JSON object. Keys are property names, values are property values. " +
+        'Example: { "Name": { "title": [{ "text": { "content": "My Page" } }] }, ' +
+        '"Status": { "status": { "name": "In Progress" } } }'),
+    children: z
+        .array(z.any())
+        .optional()
+        .describe("Optional array of block objects for the page content. " +
+        'Example: [{ "type": "paragraph", "paragraph": { "rich_text": [{ "text": { "content": "Hello" } }] } }]'),
+    icon: z
+        .any()
+        .optional()
+        .describe("Optional icon for the page. " +
+        'Emoji example: { "type": "emoji", "emoji": "🚀" }. ' +
+        'External example: { "type": "external", "external": { "url": "https://..." } }'),
+    cover: z
+        .any()
+        .optional()
+        .describe("Optional cover image for the page. " +
+        'Example: { "type": "external", "external": { "url": "https://..." } }'),
+};
+export function registerCreatePage(server, notion) {
+    server.tool("create-page", "Create a new page in a Notion database. Requires a database_id and properties object.", inputSchema, async ({ database_id, properties, children, icon, cover }) => {
+        try {
+            const params = {
+                parent: { database_id },
+                properties,
+            };
+            if (children) {
+                params.children = children;
+            }
+            if (icon) {
+                params.icon = icon;
+            }
+            if (cover) {
+                params.cover = cover;
+            }
+            const response = await notion.pages.create(params);
+            return formatResponse(response);
+        }
+        catch (error) {
+            return handleError(error);
+        }
+    });
+}

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

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

@@ -0,0 +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,CAAC;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAuBxD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAkBtF"}

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

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import { 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."),
+};
+export function registerGetBlockChildren(server, notion) {
+    server.tool("get-block-children", "Retrieve the children blocks of a block or page. Returns paginated results.", inputSchema, async ({ block_id, start_cursor, page_size }) => {
+        try {
+            const response = await notion.blocks.children.list({
+                block_id,
+                start_cursor,
+                page_size,
+            });
+            return formatPaginatedResponse(response.results, response.has_more, response.next_cursor);
+        }
+        catch (error) {
+            return handleError(error);
+        }
+    });
+}

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

@@ -0,0 +1,13 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { NotionClient } from "../notion-client.js";
+import { registerAppendBlockChildren } from "./append-block-children.js";
+import { registerCreateComment } from "./create-comment.js";
+import { registerCreatePage } from "./create-page.js";
+import { registerGetBlockChildren } from "./get-block-children.js";
+import { registerQueryDatabase } from "./query-database.js";
+import { registerRetrievePage } from "./retrieve-page.js";
+import { registerSearch } from "./search.js";
+import { registerUpdatePage } from "./update-page.js";
+export declare function registerAllTools(server: McpServer, notion: NotionClient): void;
+export { registerRetrievePage, registerCreatePage, registerUpdatePage, registerQueryDatabase, registerSearch, registerGetBlockChildren, registerAppendBlockChildren, registerCreateComment, };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAkB9E;AAED,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,EACd,wBAAwB,EACxB,2BAA2B,EAC3B,qBAAqB,GACtB,CAAC"}

package/dist/src/tools/index.js

@@ -0,0 +1,24 @@
+import { registerAppendBlockChildren } from "./append-block-children.js";
+import { registerCreateComment } from "./create-comment.js";
+import { registerCreatePage } from "./create-page.js";
+import { registerGetBlockChildren } from "./get-block-children.js";
+import { registerQueryDatabase } from "./query-database.js";
+import { registerRetrievePage } from "./retrieve-page.js";
+import { registerSearch } from "./search.js";
+import { registerUpdatePage } from "./update-page.js";
+export function registerAllTools(server, notion) {
+    // Page operations
+    registerRetrievePage(server, notion);
+    registerCreatePage(server, notion);
+    registerUpdatePage(server, notion);
+    // Database operations
+    registerQueryDatabase(server, notion);
+    // Search
+    registerSearch(server, notion);
+    // Block operations
+    registerGetBlockChildren(server, notion);
+    registerAppendBlockChildren(server, notion);
+    // Comment operations
+    registerCreateComment(server, notion);
+}
+export { registerRetrievePage, registerCreatePage, registerUpdatePage, registerQueryDatabase, registerSearch, registerGetBlockChildren, registerAppendBlockChildren, registerCreateComment, };

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

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

@@ -0,0 +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,CAAC;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAuCxD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAsCnF"}

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

@@ -0,0 +1,51 @@
+import { z } from "zod";
+import { formatPaginatedResponse, handleError } from "../utils/index.js";
+const inputSchema = {
+    database_id: z.string().describe("The ID of the database to query"),
+    filter: z
+        .any()
+        .optional()
+        .describe("Filter conditions as a JSON object. " +
+        'Property filter example: { "property": "Status", "status": { "equals": "Done" } }. ' +
+        'Compound filter example: { "and": [{ "property": "Status", "status": { "equals": "Done" } }] }'),
+    sorts: z
+        .array(z.any())
+        .optional()
+        .describe("Sort conditions as an array. " +
+        'Example: [{ "property": "Created", "direction": "descending" }] or ' +
+        '[{ "timestamp": "created_time", "direction": "ascending" }]'),
+    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."),
+};
+export function registerQueryDatabase(server, notion) {
+    server.tool("query-database", "Query a Notion database with optional filters and sorts. Returns paginated results.", inputSchema, async ({ database_id, filter, sorts, start_cursor, page_size }) => {
+        try {
+            const params = { database_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;
+            }
+            const response = await notion.databases.query(params);
+            return formatPaginatedResponse(response.results, response.has_more, response.next_cursor);
+        }
+        catch (error) {
+            return handleError(error);
+        }
+    });
+}

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

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

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

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

@@ -0,0 +1,16 @@
+import { z } from "zod";
+import { formatResponse, handleError } from "../utils/index.js";
+const inputSchema = {
+    page_id: z.string().describe("The ID of the page to retrieve"),
+};
+export function registerRetrievePage(server, notion) {
+    server.tool("retrieve-page", "Retrieve a Notion page by its ID. Returns the page properties and metadata.", inputSchema, async ({ page_id }) => {
+        try {
+            const response = await notion.pages.retrieve({ page_id });
+            return formatResponse(response);
+        }
+        catch (error) {
+            return handleError(error);
+        }
+    });
+}

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/tools/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AA2CxD,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA0C5E"}

package/dist/src/tools/search.js

@@ -0,0 +1,58 @@
+import { z } from "zod";
+import { formatPaginatedResponse, handleError } from "../utils/index.js";
+const inputSchema = {
+    query: z.string().optional().describe("Text to search for in page titles and content"),
+    filter: z
+        .object({
+        value: z.enum(["page", "database"]),
+        property: z.literal("object"),
+    })
+        .optional()
+        .describe("Filter to limit results to pages or databases. " +
+        'Example: { "value": "page", "property": "object" }'),
+    sort: z
+        .object({
+        direction: z.enum(["ascending", "descending"]),
+        timestamp: z.literal("last_edited_time"),
+    })
+        .optional()
+        .describe("Sort order for results. " +
+        'Example: { "direction": "descending", "timestamp": "last_edited_time" }'),
+    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."),
+};
+export function registerSearch(server, notion) {
+    server.tool("search", "Search across all pages and databases in the workspace. Returns paginated results.", inputSchema, async ({ query, filter, sort, start_cursor, page_size }) => {
+        try {
+            const params = {};
+            if (query) {
+                params.query = query;
+            }
+            if (filter) {
+                params.filter = filter;
+            }
+            if (sort) {
+                params.sort = sort;
+            }
+            if (start_cursor) {
+                params.start_cursor = start_cursor;
+            }
+            if (page_size) {
+                params.page_size = page_size;
+            }
+            const response = await notion.search(params);
+            return formatPaginatedResponse(response.results, response.has_more, response.next_cursor);
+        }
+        catch (error) {
+            return handleError(error);
+        }
+    });
+}

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

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

@@ -0,0 +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,CAAC;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AA+BxD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAsChF"}

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

@@ -0,0 +1,47 @@
+import { z } from "zod";
+import { formatResponse, handleError } from "../utils/index.js";
+const inputSchema = {
+    page_id: z.string().describe("The ID of the page to update"),
+    properties: z
+        .record(z.string(), z.any())
+        .optional()
+        .describe("Properties to update as a JSON object. Keys are property names, values are property values. " +
+        'Example: { "Status": { "status": { "name": "Done" } } }'),
+    archived: z.boolean().optional().describe("Set to true to archive (delete) the page"),
+    icon: z
+        .any()
+        .optional()
+        .describe("Optional icon for the page. " +
+        'Emoji example: { "type": "emoji", "emoji": "🚀" }. ' +
+        "Set to null to remove the icon."),
+    cover: z
+        .any()
+        .optional()
+        .describe("Optional cover image for the page. " +
+        'Example: { "type": "external", "external": { "url": "https://..." } }. ' +
+        "Set to null to remove the cover."),
+};
+export function registerUpdatePage(server, notion) {
+    server.tool("update-page", "Update a Notion page's properties, icon, cover, or archive status.", inputSchema, async ({ page_id, properties, archived, icon, cover }) => {
+        try {
+            const params = { page_id };
+            if (properties !== undefined) {
+                params.properties = properties;
+            }
+            if (archived !== undefined) {
+                params.archived = archived;
+            }
+            if (icon !== undefined) {
+                params.icon = icon;
+            }
+            if (cover !== undefined) {
+                params.cover = cover;
+            }
+            const response = await notion.pages.update(params);
+            return formatResponse(response);
+        }
+        catch (error) {
+            return handleError(error);
+        }
+    });
+}

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

@@ -0,0 +1,11 @@
+export interface McpTextContent {
+    type: "text";
+    text: string;
+}
+export interface McpResponse {
+    [key: string]: unknown;
+    content: McpTextContent[];
+    isError?: boolean;
+}
+export declare function handleError(error: unknown): McpResponse;
+//# sourceMappingURL=error-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAaD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAoBvD"}

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

@@ -0,0 +1,64 @@
+function isNotionApiError(error) {
+    if (!(error instanceof Error))
+        return false;
+    const errObj = error;
+    return typeof errObj.code === "string" && typeof errObj.message === "string";
+}
+export function handleError(error) {
+    if (isNotionApiError(error)) {
+        const message = formatNotionError(error);
+        return {
+            content: [{ type: "text", text: `Notion API Error: ${message}` }],
+            isError: true,
+        };
+    }
+    if (error instanceof Error) {
+        return {
+            content: [{ type: "text", text: `Error: ${error.message}` }],
+            isError: true,
+        };
+    }
+    return {
+        content: [{ type: "text", text: `Unknown error: ${String(error)}` }],
+        isError: true,
+    };
+}
+// Notion API error codes
+const NOTION_ERROR_CODES = {
+    object_not_found: "object_not_found",
+    unauthorized: "unauthorized",
+    rate_limited: "rate_limited",
+    invalid_json: "invalid_json",
+    invalid_request_url: "invalid_request_url",
+    invalid_request: "invalid_request",
+    validation_error: "validation_error",
+    conflict_error: "conflict_error",
+    internal_server_error: "internal_server_error",
+    service_unavailable: "service_unavailable",
+};
+function formatNotionError(error) {
+    switch (error.code) {
+        case NOTION_ERROR_CODES.object_not_found:
+            return `Object not found. Please check the ID is correct and the integration has access. Details: ${error.message}`;
+        case NOTION_ERROR_CODES.unauthorized:
+            return `Unauthorized. Please check your NOTION_TOKEN is valid and has the required permissions. Details: ${error.message}`;
+        case NOTION_ERROR_CODES.rate_limited:
+            return `Rate limited. Please wait and retry. Details: ${error.message}`;
+        case NOTION_ERROR_CODES.invalid_json:
+            return `Invalid JSON in request. Details: ${error.message}`;
+        case NOTION_ERROR_CODES.invalid_request_url:
+            return `Invalid request URL. Details: ${error.message}`;
+        case NOTION_ERROR_CODES.invalid_request:
+            return `Invalid request. Details: ${error.message}`;
+        case NOTION_ERROR_CODES.validation_error:
+            return `Validation error: ${error.message}`;
+        case NOTION_ERROR_CODES.conflict_error:
+            return `Conflict error. The resource may have been modified. Details: ${error.message}`;
+        case NOTION_ERROR_CODES.internal_server_error:
+            return `Notion internal server error. Please retry later. Details: ${error.message}`;
+        case NOTION_ERROR_CODES.service_unavailable:
+            return `Notion service unavailable. Please retry later. Details: ${error.message}`;
+        default:
+            return error.message;
+    }
+}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACxF,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,oBAAoB,GACrB,MAAM,yBAAyB,CAAC"}

package/dist/src/utils/index.js

@@ -0,0 +1,2 @@
+export { handleError } from "./error-handler.js";
+export { formatPaginatedResponse, formatResponse, formatSuccessMessage, } from "./response-formatter.js";

package/dist/src/utils/response-formatter.d.ts

@@ -0,0 +1,5 @@
+import type { McpResponse } from "./error-handler.js";
+export declare function formatResponse(data: unknown): McpResponse;
+export declare function formatSuccessMessage(message: string): McpResponse;
+export declare function formatPaginatedResponse(data: unknown, hasMore: boolean, nextCursor: string | null): McpResponse;
+//# sourceMappingURL=response-formatter.d.ts.map

package/dist/src/utils/response-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-formatter.d.ts","sourceRoot":"","sources":["../../../src/utils/response-formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,CASzD;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAIjE;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,GAAG,IAAI,GACxB,WAAW,CAcb"}

package/dist/src/utils/response-formatter.js

@@ -0,0 +1,30 @@
+export function formatResponse(data) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(data, null, 2),
+            },
+        ],
+    };
+}
+export function formatSuccessMessage(message) {
+    return {
+        content: [{ type: "text", text: message }],
+    };
+}
+export function formatPaginatedResponse(data, hasMore, nextCursor) {
+    const result = {
+        data,
+        has_more: hasMore,
+        next_cursor: nextCursor,
+    };
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@atikk-co-jp/notion-mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for Notion API - Create, read, update pages and databases",
+  "type": "module",
+  "license": "MIT",
+  "author": "atikk-co-jp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/atikk-co-jp/notion-mcp-server.git"
+  },
+  "homepage": "https://github.com/atikk-co-jp/notion-mcp-server#readme",
+  "bugs": {
+    "url": "https://github.com/atikk-co-jp/notion-mcp-server/issues"
+  },
+  "keywords": [
+    "mcp",
+    "notion",
+    "api",
+    "model-context-protocol"
+  ],
+  "bin": {
+    "atikk-notion-mcp-server": "./dist/bin/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "README.ja.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "dev": "tsx watch bin/cli.ts",
+    "start": "tsx bin/cli.ts",
+    "prepublishOnly": "pnpm build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "5.9.3"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}