@vineethnkrishnan/notion-mcp 0.1.1

package/build/common/types.d.ts

@@ -0,0 +1,11 @@
+export interface NotionConfig {
+    apiKey: string;
+    notionVersion: string;
+}
+export interface McpToolResponse {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}

package/build/common/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/build/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/common/types.ts"],"names":[],"mappings":""}

package/build/common/utils.d.ts

@@ -0,0 +1,30 @@
+import { McpToolResponse } from "./types";
+/**
+ * Converts Notion's rich text array to a single plain text string.
+ * Handles text, mention, and equation types.
+ */
+export declare function flattenRichText(richText: unknown[]): string;
+/**
+ * Converts an array of Notion block objects to readable text lines.
+ */
+export declare function flattenBlocks(blocks: unknown[]): string[];
+/**
+ * Recursively removes specified keys from an object.
+ */
+export declare function stripNotionMetadata(obj: unknown, keys?: string[]): unknown;
+/**
+ * Limits block count, appending a truncation marker if exceeded.
+ */
+export declare function truncateBlocks(blocks: unknown[], max?: number): unknown[];
+/**
+ * Composes all Notion-specific transformations for LLM optimization.
+ */
+export declare function transformNotionResponse(data: unknown): unknown;
+/**
+ * Transforms Notion data and wraps it in the MCP tool response format.
+ */
+export declare function formatMcpResponse(data: unknown): McpToolResponse;
+/**
+ * Wraps an error in the MCP tool error response format.
+ */
+export declare function formatMcpError(error: unknown): McpToolResponse;

package/build/common/utils.js

@@ -0,0 +1,264 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flattenRichText = flattenRichText;
+exports.flattenBlocks = flattenBlocks;
+exports.stripNotionMetadata = stripNotionMetadata;
+exports.truncateBlocks = truncateBlocks;
+exports.transformNotionResponse = transformNotionResponse;
+exports.formatMcpResponse = formatMcpResponse;
+exports.formatMcpError = formatMcpError;
+const NOTION_STRIP_KEYS = ["object", "request_id", "developer_survey", "public_url"];
+// ===========================================================================
+// Rich text flattening
+// ===========================================================================
+/**
+ * Converts Notion's rich text array to a single plain text string.
+ * Handles text, mention, and equation types.
+ */
+function flattenRichText(richText) {
+    if (!Array.isArray(richText))
+        return "";
+    return richText
+        .map((segment) => {
+        if (!segment || typeof segment !== "object")
+            return "";
+        const record = segment;
+        if (record.plain_text && typeof record.plain_text === "string") {
+            return record.plain_text;
+        }
+        const type = record.type;
+        if (type === "text") {
+            const text = record.text;
+            return text?.content ?? "";
+        }
+        if (type === "mention") {
+            const mention = record.mention;
+            if (!mention)
+                return "@unknown";
+            const mentionType = mention.type;
+            if (mentionType === "user") {
+                const user = mention.user;
+                return `@${user?.name ?? "unknown"}`;
+            }
+            if (mentionType === "page") {
+                return "[page mention]";
+            }
+            if (mentionType === "database") {
+                return "[database mention]";
+            }
+            if (mentionType === "date") {
+                const date = mention.date;
+                return date?.start ? String(date.start) : "[date]";
+            }
+            return `@${mentionType}`;
+        }
+        if (type === "equation") {
+            const equation = record.equation;
+            return equation?.expression ?? "";
+        }
+        return "";
+    })
+        .join("");
+}
+// ===========================================================================
+// Block rendering
+// ===========================================================================
+/**
+ * Extracts text content from a block by looking at its type-specific data.
+ */
+function getBlockText(block) {
+    const type = block.type;
+    if (!type)
+        return "";
+    const data = block[type];
+    if (!data)
+        return "";
+    const richText = data.rich_text;
+    if (richText)
+        return flattenRichText(richText);
+    return "";
+}
+/**
+ * Renders a single Notion block to a markdown-like plain text line.
+ */
+function renderBlock(block, depth) {
+    const type = block.type;
+    if (!type)
+        return "";
+    const indent = "  ".repeat(depth);
+    const text = getBlockText(block);
+    switch (type) {
+        case "paragraph":
+            return `${indent}${text}`;
+        case "heading_1":
+            return `${indent}# ${text}`;
+        case "heading_2":
+            return `${indent}## ${text}`;
+        case "heading_3":
+            return `${indent}### ${text}`;
+        case "bulleted_list_item":
+            return `${indent}- ${text}`;
+        case "numbered_list_item":
+            return `${indent}1. ${text}`;
+        case "to_do": {
+            const data = block[type];
+            const isChecked = data?.checked === true;
+            return `${indent}${isChecked ? "[x]" : "[ ]"} ${text}`;
+        }
+        case "toggle":
+            return `${indent}> ${text}`;
+        case "code": {
+            const data = block[type];
+            const language = data?.language ?? "";
+            return `${indent}\`\`\`${language}\n${indent}${text}\n${indent}\`\`\``;
+        }
+        case "quote":
+            return `${indent}> ${text}`;
+        case "divider":
+            return `${indent}---`;
+        case "callout": {
+            const data = block[type];
+            const icon = data?.icon;
+            const emoji = icon?.type === "emoji" ? icon.emoji : "";
+            return `${indent}${emoji ? emoji + " " : ""}${text}`;
+        }
+        case "image": {
+            const data = block[type];
+            const caption = data?.caption;
+            const captionText = caption ? flattenRichText(caption) : "";
+            let url = "";
+            if (data?.type === "external") {
+                const external = data.external;
+                url = external?.url ?? "";
+            }
+            else if (data?.type === "file") {
+                const file = data.file;
+                url = file?.url ?? "";
+            }
+            return `${indent}[Image: ${captionText || url}]`;
+        }
+        case "bookmark": {
+            const data = block[type];
+            const url = data?.url ?? "";
+            return `${indent}[Bookmark: ${url}]`;
+        }
+        case "table_row": {
+            const data = block[type];
+            const cells = data?.cells;
+            if (!cells)
+                return `${indent}| |`;
+            const cellTexts = cells.map((cell) => flattenRichText(cell));
+            return `${indent}| ${cellTexts.join(" | ")} |`;
+        }
+        case "child_page": {
+            const data = block[type];
+            const title = data?.title ?? "";
+            return `${indent}[Child page: ${title}]`;
+        }
+        case "child_database": {
+            const data = block[type];
+            const title = data?.title ?? "";
+            return `${indent}[Child database: ${title}]`;
+        }
+        case "embed": {
+            const data = block[type];
+            const url = data?.url ?? "";
+            return `${indent}[Embed: ${url}]`;
+        }
+        case "synced_block":
+            return `${indent}[Synced block]`;
+        case "column_list":
+        case "column":
+            return "";
+        default:
+            return text ? `${indent}${text}` : `${indent}[${type} block]`;
+    }
+}
+/**
+ * Converts an array of Notion block objects to readable text lines.
+ */
+function flattenBlocks(blocks) {
+    if (!Array.isArray(blocks))
+        return [];
+    const lines = [];
+    for (const block of blocks) {
+        if (!block || typeof block !== "object")
+            continue;
+        const record = block;
+        const depth = record._depth ?? 0;
+        const line = renderBlock(record, depth);
+        if (line !== "") {
+            lines.push(line);
+        }
+    }
+    return lines;
+}
+// ===========================================================================
+// Metadata stripping
+// ===========================================================================
+/**
+ * Recursively removes specified keys from an object.
+ */
+function stripNotionMetadata(obj, keys = NOTION_STRIP_KEYS) {
+    if (obj === null || obj === undefined)
+        return obj;
+    if (Array.isArray(obj))
+        return obj.map((item) => stripNotionMetadata(item, keys));
+    if (typeof obj !== "object")
+        return obj;
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (keys.includes(key))
+            continue;
+        result[key] = stripNotionMetadata(value, keys);
+    }
+    return result;
+}
+// ===========================================================================
+// Block truncation
+// ===========================================================================
+/**
+ * Limits block count, appending a truncation marker if exceeded.
+ */
+function truncateBlocks(blocks, max = 100) {
+    if (!Array.isArray(blocks) || blocks.length <= max)
+        return blocks;
+    const truncated = blocks.slice(0, max);
+    truncated.push({
+        _truncated: true,
+        message: `[Truncated: showing ${max} of ${blocks.length} total blocks]`,
+    });
+    return truncated;
+}
+// ===========================================================================
+// Composed transform
+// ===========================================================================
+/**
+ * Composes all Notion-specific transformations for LLM optimization.
+ */
+function transformNotionResponse(data) {
+    return stripNotionMetadata(data);
+}
+// ===========================================================================
+// MCP response formatting
+// ===========================================================================
+/**
+ * Transforms Notion data and wraps it in the MCP tool response format.
+ */
+function formatMcpResponse(data) {
+    const transformed = transformNotionResponse(data);
+    return {
+        content: [{ type: "text", text: JSON.stringify(transformed, null, 2) }],
+    };
+}
+/**
+ * Wraps an error in the MCP tool error response format.
+ */
+function formatMcpError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=utils.js.map

package/build/common/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/common/utils.ts"],"names":[],"mappings":"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"}

package/build/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/build/index.js

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const zod_1 = require("zod");
+const notion_service_1 = require("./services/notion.service");
+const search_tools_1 = require("./tools/search.tools");
+const page_tools_1 = require("./tools/page.tools");
+const database_tools_1 = require("./tools/database.tools");
+const user_tools_1 = require("./tools/user.tools");
+// Validate required config
+const NOTION_API_KEY = process.env.NOTION_API_KEY;
+if (!NOTION_API_KEY) {
+    console.error("NOTION_API_KEY environment variable is required.");
+    process.exit(1);
+}
+const notionService = new notion_service_1.NotionService({
+    apiKey: NOTION_API_KEY,
+    notionVersion: process.env.NOTION_VERSION ?? "2022-06-28",
+});
+// Initialize tool classes
+const tools = {
+    search: new search_tools_1.SearchTools(notionService),
+    pages: new page_tools_1.PageTools(notionService),
+    databases: new database_tools_1.DatabaseTools(notionService),
+    users: new user_tools_1.UserTools(notionService),
+};
+// Combine all schemas
+const AllToolSchemas = {
+    ...search_tools_1.SearchToolSchemas,
+    ...page_tools_1.PageToolSchemas,
+    ...database_tools_1.DatabaseToolSchemas,
+    ...user_tools_1.UserToolSchemas,
+};
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const { version } = require("../package.json");
+const server = new index_js_1.Server({
+    name: "notion-mcp",
+    version,
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+/**
+ * Handler for listing available tools.
+ */
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+    return {
+        tools: Object.entries(AllToolSchemas).map(([name, config]) => ({
+            name,
+            description: config.description,
+            inputSchema: zod_1.z.toJSONSchema(config.schema),
+        })),
+    };
+});
+const toolRegistry = {};
+for (const name of Object.keys(search_tools_1.SearchToolSchemas)) {
+    toolRegistry[name] = (args) => tools.search[name](args);
+}
+for (const name of Object.keys(page_tools_1.PageToolSchemas)) {
+    toolRegistry[name] = (args) => tools.pages[name](args);
+}
+for (const name of Object.keys(database_tools_1.DatabaseToolSchemas)) {
+    toolRegistry[name] = (args) => tools.databases[name](args);
+}
+for (const name of Object.keys(user_tools_1.UserToolSchemas)) {
+    toolRegistry[name] = (args) => tools.users[name](args);
+}
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    try {
+        const { name, arguments: args } = request.params;
+        const handler = toolRegistry[name];
+        if (!handler) {
+            throw new types_js_1.McpError(types_js_1.ErrorCode.MethodNotFound, `Tool not found: ${name}`);
+        }
+        return await handler(args ?? {});
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+});
+/**
+ * Start the server using Stdio transport.
+ */
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error("Notion MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Server error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/build/services/notion.service.d.ts

@@ -0,0 +1,17 @@
+import { NotionConfig } from "../common/types";
+export declare class NotionService {
+    private baseUrl;
+    private apiKey;
+    private notionVersion;
+    constructor(config: NotionConfig);
+    private request;
+    search(query?: string, filter?: {
+        property: "object";
+        value: "page" | "database";
+    }, limit?: number): Promise<unknown>;
+    getPage(pageId: string): Promise<unknown>;
+    getPageContent(blockId: string, maxDepth?: number, maxBlocks?: number): Promise<unknown[]>;
+    getDatabase(databaseId: string): Promise<unknown>;
+    queryDatabase(databaseId: string, filter?: unknown, sorts?: unknown, limit?: number): Promise<unknown>;
+    listUsers(limit?: number): Promise<unknown>;
+}

package/build/services/notion.service.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotionService = void 0;
+class NotionService {
+    baseUrl;
+    apiKey;
+    notionVersion;
+    constructor(config) {
+        this.baseUrl = "https://api.notion.com/v1";
+        this.apiKey = config.apiKey;
+        this.notionVersion = config.notionVersion;
+    }
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const options = {
+            method,
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                "Notion-Version": this.notionVersion,
+                "Content-Type": "application/json",
+            },
+        };
+        if (body && method === "POST") {
+            options.body = JSON.stringify(body);
+        }
+        const response = await fetch(url, options);
+        if (!response.ok) {
+            const errorBody = await response.text().catch(() => "");
+            switch (response.status) {
+                case 401:
+                    throw new Error("Authentication failed. Check your NOTION_API_KEY.");
+                case 403:
+                    throw new Error("Access denied. Ensure the Notion integration is connected to this page/database via the 'Connect to' menu.");
+                case 404:
+                    throw new Error("Not found. The page/database may not exist or may not be shared with your integration.");
+                case 429: {
+                    const retryAfter = response.headers.get("Retry-After") ?? "unknown";
+                    throw new Error(`Rate limited by Notion. Retry after ${retryAfter} seconds.`);
+                }
+                default:
+                    throw new Error(`Notion API error (${response.status}): ${errorBody || response.statusText}`);
+            }
+        }
+        return response.json();
+    }
+    // ===========================================================================
+    // Search
+    // ===========================================================================
+    async search(query, filter, limit = 10) {
+        const body = { page_size: Math.min(limit, 100) };
+        if (query)
+            body.query = query;
+        if (filter)
+            body.filter = filter;
+        return this.request("POST", "/search", body);
+    }
+    // ===========================================================================
+    // Pages
+    // ===========================================================================
+    async getPage(pageId) {
+        return this.request("GET", `/pages/${pageId}`);
+    }
+    async getPageContent(blockId, maxDepth = 3, maxBlocks = 100) {
+        const allBlocks = [];
+        const fetchChildren = async (parentId, depth) => {
+            if (depth > maxDepth || allBlocks.length >= maxBlocks)
+                return;
+            const result = await this.request("GET", `/blocks/${parentId}/children?page_size=100`);
+            for (const block of result.results) {
+                if (allBlocks.length >= maxBlocks)
+                    break;
+                allBlocks.push({ ...block, _depth: depth });
+                if (block.has_children === true) {
+                    await fetchChildren(block.id, depth + 1);
+                }
+            }
+        };
+        await fetchChildren(blockId, 0);
+        return allBlocks;
+    }
+    // ===========================================================================
+    // Databases
+    // ===========================================================================
+    async getDatabase(databaseId) {
+        return this.request("GET", `/databases/${databaseId}`);
+    }
+    async queryDatabase(databaseId, filter, sorts, limit = 25) {
+        const body = { page_size: Math.min(limit, 100) };
+        if (filter)
+            body.filter = filter;
+        if (sorts)
+            body.sorts = sorts;
+        return this.request("POST", `/databases/${databaseId}/query`, body);
+    }
+    // ===========================================================================
+    // Users
+    // ===========================================================================
+    async listUsers(limit = 25) {
+        return this.request("GET", `/users?page_size=${Math.min(limit, 100)}`);
+    }
+}
+exports.NotionService = NotionService;
+//# sourceMappingURL=notion.service.js.map

package/build/services/notion.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notion.service.js","sourceRoot":"","sources":["../../src/services/notion.service.ts"],"names":[],"mappings":"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"}

package/build/tools/database.tools.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import { NotionService } from "../services/notion.service";
+export declare const DatabaseToolSchemas: {
+    get_database: {
+        description: string;
+        schema: z.ZodObject<{
+            database_id: z.ZodString;
+        }, z.core.$strip>;
+    };
+    query_database: {
+        description: string;
+        schema: z.ZodObject<{
+            database_id: z.ZodString;
+            filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            sorts: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, z.core.$strip>;
+    };
+};
+export declare class DatabaseTools {
+    private notionService;
+    constructor(notionService: NotionService);
+    get_database(args: z.infer<typeof DatabaseToolSchemas.get_database.schema>): Promise<import("../common/types").McpToolResponse>;
+    query_database(args: z.infer<typeof DatabaseToolSchemas.query_database.schema>): Promise<import("../common/types").McpToolResponse>;
+}

package/build/tools/database.tools.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseTools = exports.DatabaseToolSchemas = void 0;
+const zod_1 = require("zod");
+const utils_1 = require("../common/utils");
+exports.DatabaseToolSchemas = {
+    get_database: {
+        description: "Retrieves database metadata including title, description, and property schema (column definitions). Use this to understand the structure of a database before querying it.",
+        schema: zod_1.z.object({
+            database_id: zod_1.z.string().describe("The Notion database ID (UUID or 32-char hex)."),
+        }),
+    },
+    query_database: {
+        description: "Queries a Notion database with optional filter and sort objects. Returns matching entries with all property values. Use Notion's native filter syntax.",
+        schema: zod_1.z.object({
+            database_id: zod_1.z.string().describe("The Notion database ID (UUID or 32-char hex)."),
+            filter: zod_1.z
+                .record(zod_1.z.string(), zod_1.z.unknown())
+                .optional()
+                .describe("Notion filter object (see Notion API docs for filter syntax)."),
+            sorts: zod_1.z
+                .array(zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()))
+                .optional()
+                .describe("Array of Notion sort objects."),
+            limit: zod_1.z.number().optional().default(25).describe("Max results (max 100)."),
+        }),
+    },
+};
+class DatabaseTools {
+    notionService;
+    constructor(notionService) {
+        this.notionService = notionService;
+    }
+    async get_database(args) {
+        const database = await this.notionService.getDatabase(args.database_id);
+        return (0, utils_1.formatMcpResponse)(database);
+    }
+    async query_database(args) {
+        const result = await this.notionService.queryDatabase(args.database_id, args.filter, args.sorts, args.limit);
+        return (0, utils_1.formatMcpResponse)(result);
+    }
+}
+exports.DatabaseTools = DatabaseTools;
+//# sourceMappingURL=database.tools.js.map

package/build/tools/database.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.tools.js","sourceRoot":"","sources":["../../src/tools/database.tools.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,2CAAoD;AAEvC,QAAA,mBAAmB,GAAG;IACjC,YAAY,EAAE;QACZ,WAAW,EACT,4KAA4K;QAC9K,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;SAClF,CAAC;KACH;IACD,cAAc,EAAE;QACd,WAAW,EACT,wJAAwJ;QAC1J,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;YACjF,MAAM,EAAE,OAAC;iBACN,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC;iBAC/B,QAAQ,EAAE;iBACV,QAAQ,CAAC,+DAA+D,CAAC;YAC5E,KAAK,EAAE,OAAC;iBACL,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC;iBACxC,QAAQ,EAAE;iBACV,QAAQ,CAAC,+BAA+B,CAAC;YAC5C,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;SAC5E,CAAC;KACH;CACF,CAAC;AAEF,MAAa,aAAa;IACJ;IAApB,YAAoB,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;IAAG,CAAC;IAEpD,KAAK,CAAC,YAAY,CAAC,IAA6D;QAC9E,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxE,OAAO,IAAA,yBAAiB,EAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,IAA+D;QAClF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,aAAa,CACnD,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,KAAK,CACX,CAAC;QACF,OAAO,IAAA,yBAAiB,EAAC,MAAM,CAAC,CAAC;IACnC,CAAC;CACF;AAjBD,sCAiBC"}

package/build/tools/page.tools.d.ts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import { NotionService } from "../services/notion.service";
+export declare const PageToolSchemas: {
+    get_page: {
+        description: string;
+        schema: z.ZodObject<{
+            page_id: z.ZodString;
+        }, z.core.$strip>;
+    };
+    get_page_content: {
+        description: string;
+        schema: z.ZodObject<{
+            page_id: z.ZodString;
+            max_depth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, z.core.$strip>;
+    };
+};
+export declare class PageTools {
+    private notionService;
+    constructor(notionService: NotionService);
+    get_page(args: z.infer<typeof PageToolSchemas.get_page.schema>): Promise<import("../common/types").McpToolResponse>;
+    get_page_content(args: z.infer<typeof PageToolSchemas.get_page_content.schema>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+}

package/build/tools/page.tools.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PageTools = exports.PageToolSchemas = void 0;
+const zod_1 = require("zod");
+const utils_1 = require("../common/utils");
+exports.PageToolSchemas = {
+    get_page: {
+        description: "Retrieves page properties including title, created time, last edited time, parent, and all property values. Use when you have a specific page ID.",
+        schema: zod_1.z.object({
+            page_id: zod_1.z.string().describe("The Notion page ID (UUID or 32-char hex)."),
+        }),
+    },
+    get_page_content: {
+        description: "Retrieves the full content of a page as readable text blocks. Recursively fetches nested blocks (toggles, columns, etc.) up to a configurable depth. Returns flattened plain text optimized for LLM consumption.",
+        schema: zod_1.z.object({
+            page_id: zod_1.z.string().describe("The Notion page ID (UUID or 32-char hex)."),
+            max_depth: zod_1.z
+                .number()
+                .optional()
+                .default(3)
+                .describe("Maximum recursion depth for nested blocks (default: 3)."),
+        }),
+    },
+};
+class PageTools {
+    notionService;
+    constructor(notionService) {
+        this.notionService = notionService;
+    }
+    async get_page(args) {
+        const page = await this.notionService.getPage(args.page_id);
+        return (0, utils_1.formatMcpResponse)(page);
+    }
+    async get_page_content(args) {
+        const blocks = await this.notionService.getPageContent(args.page_id, args.max_depth);
+        const truncated = (0, utils_1.truncateBlocks)(blocks);
+        const lines = (0, utils_1.flattenBlocks)(truncated);
+        return {
+            content: [{ type: "text", text: lines.join("\n") }],
+        };
+    }
+}
+exports.PageTools = PageTools;
+//# sourceMappingURL=page.tools.js.map

package/build/tools/page.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.tools.js","sourceRoot":"","sources":["../../src/tools/page.tools.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,2CAAmF;AAEtE,QAAA,eAAe,GAAG;IAC7B,QAAQ,EAAE;QACR,WAAW,EACT,mJAAmJ;QACrJ,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;SAC1E,CAAC;KACH;IACD,gBAAgB,EAAE;QAChB,WAAW,EACT,kNAAkN;QACpN,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;YACzE,SAAS,EAAE,OAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,OAAO,CAAC,CAAC,CAAC;iBACV,QAAQ,CAAC,yDAAyD,CAAC;SACvE,CAAC;KACH;CACF,CAAC;AAEF,MAAa,SAAS;IACA;IAApB,YAAoB,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;IAAG,CAAC;IAEpD,KAAK,CAAC,QAAQ,CAAC,IAAqD;QAClE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5D,OAAO,IAAA,yBAAiB,EAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,IAA6D;QAClF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACrF,MAAM,SAAS,GAAG,IAAA,sBAAc,EAAC,MAAM,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,IAAA,qBAAa,EAAC,SAAS,CAAC,CAAC;QACvC,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;SACpD,CAAC;IACJ,CAAC;CACF;AAhBD,8BAgBC"}

package/build/tools/search.tools.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+import { NotionService } from "../services/notion.service";
+export declare const SearchToolSchemas: {
+    search: {
+        description: string;
+        schema: z.ZodObject<{
+            query: z.ZodOptional<z.ZodString>;
+            filter: z.ZodOptional<z.ZodEnum<{
+                page: "page";
+                database: "database";
+            }>>;
+            limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, z.core.$strip>;
+    };
+};
+export declare class SearchTools {
+    private notionService;
+    constructor(notionService: NotionService);
+    search(args: z.infer<typeof SearchToolSchemas.search.schema>): Promise<import("../common/types").McpToolResponse>;
+}

package/build/tools/search.tools.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchTools = exports.SearchToolSchemas = void 0;
+const zod_1 = require("zod");
+const utils_1 = require("../common/utils");
+exports.SearchToolSchemas = {
+    search: {
+        description: "Searches across all pages and databases in the Notion workspace. Use this to find content by title or text. Only returns content shared with the integration.",
+        schema: zod_1.z.object({
+            query: zod_1.z.string().optional().describe("Search query text."),
+            filter: zod_1.z
+                .enum(["page", "database"])
+                .optional()
+                .describe("Filter results to only pages or only databases."),
+            limit: zod_1.z.number().optional().default(10).describe("Max results (max 100)."),
+        }),
+    },
+};
+class SearchTools {
+    notionService;
+    constructor(notionService) {
+        this.notionService = notionService;
+    }
+    async search(args) {
+        const filter = args.filter ? { property: "object", value: args.filter } : undefined;
+        const result = await this.notionService.search(args.query, filter, args.limit);
+        return (0, utils_1.formatMcpResponse)(result);
+    }
+}
+exports.SearchTools = SearchTools;
+//# sourceMappingURL=search.tools.js.map

package/build/tools/search.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.tools.js","sourceRoot":"","sources":["../../src/tools/search.tools.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,2CAAoD;AAEvC,QAAA,iBAAiB,GAAG;IAC/B,MAAM,EAAE;QACN,WAAW,EACT,+JAA+J;QACjK,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;YAC3D,MAAM,EAAE,OAAC;iBACN,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;iBAC1B,QAAQ,EAAE;iBACV,QAAQ,CAAC,iDAAiD,CAAC;YAC9D,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;SAC5E,CAAC;KACH;CACF,CAAC;AAEF,MAAa,WAAW;IACF;IAApB,YAAoB,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;IAAG,CAAC;IAEpD,KAAK,CAAC,MAAM,CAAC,IAAqD;QAChE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAiB,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7F,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/E,OAAO,IAAA,yBAAiB,EAAC,MAAM,CAAC,CAAC;IACnC,CAAC;CACF;AARD,kCAQC"}

package/build/tools/user.tools.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+import { NotionService } from "../services/notion.service";
+export declare const UserToolSchemas: {
+    list_users: {
+        description: string;
+        schema: z.ZodObject<{
+            limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, z.core.$strip>;
+    };
+};
+export declare class UserTools {
+    private notionService;
+    constructor(notionService: NotionService);
+    list_users(args: z.infer<typeof UserToolSchemas.list_users.schema>): Promise<import("../common/types").McpToolResponse>;
+}

package/build/tools/user.tools.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserTools = exports.UserToolSchemas = void 0;
+const zod_1 = require("zod");
+const utils_1 = require("../common/utils");
+exports.UserToolSchemas = {
+    list_users: {
+        description: "Lists all users in the Notion workspace including name, email, type (person/bot), and avatar URL.",
+        schema: zod_1.z.object({
+            limit: zod_1.z.number().optional().default(25).describe("Max results (max 100)."),
+        }),
+    },
+};
+class UserTools {
+    notionService;
+    constructor(notionService) {
+        this.notionService = notionService;
+    }
+    async list_users(args) {
+        const users = await this.notionService.listUsers(args.limit);
+        return (0, utils_1.formatMcpResponse)(users);
+    }
+}
+exports.UserTools = UserTools;
+//# sourceMappingURL=user.tools.js.map

package/build/tools/user.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.tools.js","sourceRoot":"","sources":["../../src/tools/user.tools.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,2CAAoD;AAEvC,QAAA,eAAe,GAAG;IAC7B,UAAU,EAAE;QACV,WAAW,EACT,mGAAmG;QACrG,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;SAC5E,CAAC;KACH;CACF,CAAC;AAEF,MAAa,SAAS;IACA;IAApB,YAAoB,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;IAAG,CAAC;IAEpD,KAAK,CAAC,UAAU,CAAC,IAAuD;QACtE,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7D,OAAO,IAAA,yBAAiB,EAAC,KAAK,CAAC,CAAC;IAClC,CAAC;CACF;AAPD,8BAOC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@vineethnkrishnan/notion-mcp",
+  "version": "0.1.1",
+  "description": "A read-only MCP server for the Notion API, enabling AI assistants to search, read pages, query databases, and list users.",
+  "main": "build/index.js",
+  "bin": {
+    "notion-mcp": "build/index.js"
+  },
+  "files": [
+    "build/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node build/index.js",
+    "test": "jest --coverage"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "mcp",
+    "notion",
+    "ai",
+    "model-context-protocol",
+    "knowledge-base",
+    "wiki",
+    "databases"
+  ],
+  "author": "Vineeth Krishnan",
+  "license": "MIT",
+  "type": "commonjs",
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.5.0",
+    "jest": "^30.3.0",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.7.0"
+  }
+}