@mcp-monorepo/notion-query 1.1.0 → 1.2.0

package/dist/index.js

@@ -1,10 +1,12 @@
 #!/usr/bin/env node
 import { createMcpServer } from '@mcp-monorepo/shared';
-import { registerNotionQueryTool } from './tools/notion-query.js';
+import { registerCreatePagesTool } from './tools/create-pages.js';
+import { registerFetchTool } from './tools/fetch.js';
+import { registerQueryDatasourceTool } from './tools/query-datasource.js';
 createMcpServer({
     name: 'notion-query',
     importMetaPath: import.meta.filename,
     title: 'Notion Query MCP Server',
-    tools: [registerNotionQueryTool],
+    tools: [registerQueryDatasourceTool, registerFetchTool, registerCreatePagesTool],
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAEtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AAEjE,eAAe,CAAC;IACd,IAAI,EAAE,cAAc;IACpB,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ;IACpC,KAAK,EAAE,yBAAyB;IAChC,KAAK,EAAE,CAAC,uBAAuB,CAAC;CACjC,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAEtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAA;AAEzE,eAAe,CAAC;IACd,IAAI,EAAE,cAAc;IACpB,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ;IACpC,KAAK,EAAE,yBAAyB;IAChC,KAAK,EAAE,CAAC,2BAA2B,EAAE,iBAAiB,EAAE,uBAAuB,CAAC;CACjF,CAAC,CAAA"}

package/dist/lib/client.d.ts

@@ -0,0 +1,9 @@
+import { Client } from '@notionhq/client';
+/**
+ * Initializes and returns a singleton instance of the Notion SDK Client.
+ * It retrieves the NOTION_API_KEY from the environment variables.
+ * @throws {Error} If the NOTION_API_KEY environment variable is not set.
+ * @returns {Client} The initialized Notion client.
+ */
+export declare function getNotionClient(): Client;
+//# sourceMappingURL=client.d.ts.map

package/dist/lib/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAIzC;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,MAAM,CASxC"}

package/dist/lib/client.js

@@ -0,0 +1,19 @@
+import { Client } from '@notionhq/client';
+let notionClient;
+/**
+ * Initializes and returns a singleton instance of the Notion SDK Client.
+ * It retrieves the NOTION_API_KEY from the environment variables.
+ * @throws {Error} If the NOTION_API_KEY environment variable is not set.
+ * @returns {Client} The initialized Notion client.
+ */
+export function getNotionClient() {
+    if (!notionClient) {
+        const NOTION_API_KEY = process.env.NOTION_API_KEY;
+        if (!NOTION_API_KEY) {
+            throw new Error('NOTION_API_KEY environment variable is not set.');
+        }
+        notionClient = new Client({ auth: NOTION_API_KEY });
+    }
+    return notionClient;
+}
+//# sourceMappingURL=client.js.map

package/dist/lib/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAEzC,IAAI,YAAgC,CAAA;AAEpC;;;;;GAKG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAA;QACjD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;QACpE,CAAC;QACD,YAAY,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAA;IACrD,CAAC;IACD,OAAO,YAAY,CAAA;AACrB,CAAC"}

package/dist/lib/id-utils.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Extracts a Notion page, database, or block ID from a URL or a raw ID string.
+ * Normalizes the ID by removing dashes.
+ * @param idOrUrl - The Notion URL or ID string.
+ * @returns The normalized 32-character ID, or undefined if no valid ID is found.
+ */
+export declare function normalizeId(idOrUrl: string): string | undefined;
+//# sourceMappingURL=id-utils.d.ts.map

package/dist/lib/id-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-utils.d.ts","sourceRoot":"","sources":["../../src/lib/id-utils.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO/D"}

package/dist/lib/id-utils.js

@@ -0,0 +1,20 @@
+/**
+ * A regex to extract a UUID v4 from a string.
+ * It matches UUIDs with or without dashes.
+ */
+const UUID_REGEX = /([0-9a-f]{8})-?([0-9a-f]{4})-?([0-9a-f]{4})-?([0-9a-f]{4})-?([0-9a-f]{12})/;
+/**
+ * Extracts a Notion page, database, or block ID from a URL or a raw ID string.
+ * Normalizes the ID by removing dashes.
+ * @param idOrUrl - The Notion URL or ID string.
+ * @returns The normalized 32-character ID, or undefined if no valid ID is found.
+ */
+export function normalizeId(idOrUrl) {
+    const match = idOrUrl.match(UUID_REGEX);
+    if (!match) {
+        return undefined;
+    }
+    // Reconstruct the ID without dashes
+    return match.slice(1).join('');
+}
+//# sourceMappingURL=id-utils.js.map

package/dist/lib/id-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-utils.js","sourceRoot":"","sources":["../../src/lib/id-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,GAAG,4EAA4E,CAAA;AAE/F;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;IACvC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,oCAAoC;IACpC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AAChC,CAAC"}

package/dist/lib/markdown-converter.d.ts

@@ -0,0 +1,8 @@
+import { type BlockObjectResponse } from '@notionhq/client/build/src/api-endpoints.js';
+/**
+ * Converts a list of Notion blocks to a Notion-flavored Markdown string [9].
+ * @param blocks - The array of block objects.
+ * @returns A promise that resolves to the full Markdown string.
+ */
+export declare function notionToMarkdown(blocks: BlockObjectResponse[]): Promise<string>;
+//# sourceMappingURL=markdown-converter.d.ts.map

package/dist/lib/markdown-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-converter.d.ts","sourceRoot":"","sources":["../../src/lib/markdown-converter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EAGzB,MAAM,6CAA6C,CAAA;AAqGpD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAOrF"}

package/dist/lib/markdown-converter.js

@@ -0,0 +1,95 @@
+import { NotionToMarkdown } from 'notion-to-md';
+import { getNotionClient } from './client.js';
+let n2m;
+/**
+ * Renders an array of rich text items into a Notion-flavored Markdown string.
+ * Supports bold, italic, strikethrough, underline, code, and links [9].
+ * @param richTextItems - The array of rich text items.
+ * @returns A formatted markdown string.
+ */
+function renderRichText(richTextItems) {
+    return richTextItems
+        .map((item) => {
+        let text = item.plain_text;
+        if (item.href) {
+            // Handle citations [^URL] and regular links [text](URL)
+            if (text === item.href) {
+                return `[^${item.href}]`;
+            }
+            return `[${text}](${item.href})`;
+        }
+        // Handle annotations [6]
+        if (item.annotations.code)
+            text = `\`${text}\``;
+        if (item.annotations.bold)
+            text = `**${text}**`;
+        if (item.annotations.italic)
+            text = `*${text}*`;
+        if (item.annotations.strikethrough)
+            text = `~~${text}~~`;
+        if (item.annotations.underline)
+            text = `<span underline="true">${text}</span>`;
+        return text;
+    })
+        .join('');
+}
+/**
+ * Gets a pre-configured singleton instance of NotionToMarkdown.
+ * Sets up custom transformers for Notion-flavored Markdown [9].
+ * @returns An instance of NotionToMarkdown.
+ */
+function getMarkdownConverter() {
+    if (n2m) {
+        return n2m;
+    }
+    const notionClient = getNotionClient();
+    n2m = new NotionToMarkdown({ notionClient });
+    // A generic transformer for simple blocks with rich_text and color properties [1].
+    const createColorBlockTransformer = (prefix = '') => async (block) => {
+        const blockContent = 'type' in block &&
+            block[block.type];
+        if (!blockContent) {
+            return '';
+        }
+        const markdownContent = renderRichText(blockContent.rich_text);
+        let finalMarkdown = `${prefix}${markdownContent}`;
+        if (blockContent.color && blockContent.color !== 'default') {
+            finalMarkdown += ` {color="${blockContent.color}"}`;
+        }
+        return finalMarkdown;
+    };
+    // Register transformers for block types that support color [1, 9].
+    n2m.setCustomTransformer('paragraph', createColorBlockTransformer());
+    n2m.setCustomTransformer('heading_1', createColorBlockTransformer('# '));
+    n2m.setCustomTransformer('heading_2', createColorBlockTransformer('## '));
+    n2m.setCustomTransformer('heading_3', createColorBlockTransformer('### '));
+    n2m.setCustomTransformer('bulleted_list_item', createColorBlockTransformer('- '));
+    n2m.setCustomTransformer('numbered_list_item', createColorBlockTransformer('1. '));
+    n2m.setCustomTransformer('quote', createColorBlockTransformer('> '));
+    // Custom transformer for to-do blocks to handle the checked state [9].
+    n2m.setCustomTransformer('to_do', async (block) => {
+        const todoBlock = block;
+        const prefix = todoBlock.to_do.checked ? '- [x] ' : '- [ ] ';
+        const markdownContent = renderRichText(todoBlock.to_do.rich_text);
+        let finalMarkdown = `${prefix}${markdownContent}`;
+        if (todoBlock.to_do.color && todoBlock.to_do.color !== 'default') {
+            finalMarkdown += ` {color="${todoBlock.to_do.color}"}`;
+        }
+        return finalMarkdown;
+    });
+    return n2m;
+}
+/**
+ * Converts a list of Notion blocks to a Notion-flavored Markdown string [9].
+ * @param blocks - The array of block objects.
+ * @returns A promise that resolves to the full Markdown string.
+ */
+export async function notionToMarkdown(blocks) {
+    const converter = getMarkdownConverter();
+    // The 'blocks' parameter expects the 'results' from a 'listBlockChildren' call, which matches BlockObjectResponse[]
+    const mdBlocks = await converter.blocksToMarkdown(blocks);
+    const mdString = converter.toMarkdownString(mdBlocks);
+    // `toMarkdownString` returns an object where `parent` holds the main content [7]
+    return mdString.parent ?? '';
+}
+//# sourceMappingURL=markdown-converter.js.map

package/dist/lib/markdown-converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-converter.js","sourceRoot":"","sources":["../../src/lib/markdown-converter.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAG/C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE7C,IAAI,GAAiC,CAAA;AAErC;;;;;GAKG;AACH,SAAS,cAAc,CAAC,aAAqC;IAC3D,OAAO,aAAa;SACjB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,IAAI,IAAI,GAAG,IAAI,CAAC,UAAU,CAAA;QAE1B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,wDAAwD;YACxD,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;gBACvB,OAAO,KAAK,IAAI,CAAC,IAAI,GAAG,CAAA;YAC1B,CAAC;YACD,OAAO,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI,GAAG,CAAA;QAClC,CAAC;QAED,yBAAyB;QACzB,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI;YAAE,IAAI,GAAG,KAAK,IAAI,IAAI,CAAA;QAC/C,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI;YAAE,IAAI,GAAG,KAAK,IAAI,IAAI,CAAA;QAC/C,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM;YAAE,IAAI,GAAG,IAAI,IAAI,GAAG,CAAA;QAC/C,IAAI,IAAI,CAAC,WAAW,CAAC,aAAa;YAAE,IAAI,GAAG,KAAK,IAAI,IAAI,CAAA;QACxD,IAAI,IAAI,CAAC,WAAW,CAAC,SAAS;YAAE,IAAI,GAAG,0BAA0B,IAAI,SAAS,CAAA;QAE9E,OAAO,IAAI,CAAA;IACb,CAAC,CAAC;SACD,IAAI,CAAC,EAAE,CAAC,CAAA;AACb,CAAC;AAED;;;;GAIG;AACH,SAAS,oBAAoB;IAC3B,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,MAAM,YAAY,GAAG,eAAe,EAAE,CAAA;IACtC,GAAG,GAAG,IAAI,gBAAgB,CAAC,EAAE,YAAY,EAAE,CAAC,CAAA;IAE5C,mFAAmF;IACnF,MAAM,2BAA2B,GAC/B,CAAC,SAAiB,EAAE,EAAqB,EAAE,CAC3C,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,YAAY,GAChB,MAAM,IAAI,KAAK;YACb,KAAe,CAAC,KAAK,CAAC,IAAI,CAG1B,CAAA;QAEJ,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO,EAAE,CAAA;QACX,CAAC;QAED,MAAM,eAAe,GAAG,cAAc,CAAC,YAAY,CAAC,SAAS,CAAC,CAAA;QAC9D,IAAI,aAAa,GAAG,GAAG,MAAM,GAAG,eAAe,EAAE,CAAA;QAEjD,IAAI,YAAY,CAAC,KAAK,IAAI,YAAY,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC3D,aAAa,IAAI,YAAY,YAAY,CAAC,KAAK,IAAI,CAAA;QACrD,CAAC;QAED,OAAO,aAAa,CAAA;IACtB,CAAC,CAAA;IAEH,mEAAmE;IACnE,GAAG,CAAC,oBAAoB,CAAC,WAAW,EAAE,2BAA2B,EAAE,CAAC,CAAA;IACpE,GAAG,CAAC,oBAAoB,CAAC,WAAW,EAAE,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAA;IACxE,GAAG,CAAC,oBAAoB,CAAC,WAAW,EAAE,2BAA2B,CAAC,KAAK,CAAC,CAAC,CAAA;IACzE,GAAG,CAAC,oBAAoB,CAAC,WAAW,EAAE,2BAA2B,CAAC,MAAM,CAAC,CAAC,CAAA;IAC1E,GAAG,CAAC,oBAAoB,CAAC,oBAAoB,EAAE,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAA;IACjF,GAAG,CAAC,oBAAoB,CAAC,oBAAoB,EAAE,2BAA2B,CAAC,KAAK,CAAC,CAAC,CAAA;IAClF,GAAG,CAAC,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAA;IAEpE,uEAAuE;IACvE,GAAG,CAAC,oBAAoB,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAChD,MAAM,SAAS,GAAG,KAAgC,CAAA;QAClD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAA;QAC5D,MAAM,eAAe,GAAG,cAAc,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QACjE,IAAI,aAAa,GAAG,GAAG,MAAM,GAAG,eAAe,EAAE,CAAA;QACjD,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACjE,aAAa,IAAI,YAAY,SAAS,CAAC,KAAK,CAAC,KAAK,IAAI,CAAA;QACxD,CAAC;QACD,OAAO,aAAa,CAAA;IACtB,CAAC,CAAC,CAAA;IAEF,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAA6B;IAClE,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAA;IACxC,oHAAoH;IACpH,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACzD,MAAM,QAAQ,GAAG,SAAS,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IACrD,iFAAiF;IACjF,OAAO,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAA;AAC9B,CAAC"}

package/dist/lib/parser.d.ts

@@ -0,0 +1,13 @@
+import { type DataSourceObjectResponse, type PageObjectResponse, type PartialDataSourceObjectResponse, type PartialPageObjectResponse } from '@notionhq/client';
+type SimplifiedPropertyValue = string | number | boolean | string[] | (string | number | boolean)[] | undefined;
+type SimplifiedPage = Record<string, SimplifiedPropertyValue>;
+type NotionPage = PageObjectResponse | PartialPageObjectResponse | PartialDataSourceObjectResponse | DataSourceObjectResponse;
+/**
+ * Takes an array of Notion page objects from the API and converts them into
+ * a simplified, flat array of key-value objects.
+ * @param pages The array of page objects from the Notion API response.
+ * @returns An array of simplified page objects.
+ */
+export declare const simplifyNotionPages: (pages: NotionPage[]) => SimplifiedPage[];
+export {};
+//# sourceMappingURL=parser.d.ts.map

package/dist/lib/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/lib/parser.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,+BAA+B,EACpC,KAAK,yBAAyB,EAC/B,MAAM,kBAAkB,CAAA;AAEzB,KAAK,uBAAuB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EAAE,GAAG,SAAS,CAAA;AAG/G,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAA;AAU7D,KAAK,UAAU,GACX,kBAAkB,GAClB,yBAAyB,GACzB,+BAA+B,GAC/B,wBAAwB,CAAA;AAsD5B;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAO,UAAU,EAAE,KAAG,cAAc,EA8BvE,CAAA"}

package/dist/lib/parser.js

@@ -0,0 +1,88 @@
+// notion-query/lib/parser.ts
+/**
+ * Simplifies a single Notion property object into a more readable, simple value.
+ * @param prop The Notion property object.
+ * @returns A simplified value (string, number, boolean, array, etc.) or undefined.
+ */
+const simplifyPropertyValue = (prop) => {
+    switch (prop.type) {
+        case 'title':
+            return prop.title.map((t) => t.plain_text).join('');
+        case 'rich_text':
+            return prop.rich_text.map((t) => t.plain_text).join('');
+        case 'number':
+            return prop.number;
+        case 'checkbox':
+            return prop.checkbox;
+        case 'select':
+            return prop.select?.name;
+        case 'multi_select':
+            return prop.multi_select.map((s) => s.name);
+        case 'status':
+            return prop.status?.name;
+        case 'date': {
+            const date = prop.date;
+            if (!date)
+                return undefined;
+            return date.end ? `${date.start} to ${date.end}` : date.start;
+        }
+        case 'people':
+            return prop.people.map((p) => p.name ?? p.id);
+        case 'relation':
+            return prop.relation.map((r) => r.id);
+        case 'formula': {
+            const formula = prop.formula;
+            return formula[formula.type];
+        }
+        case 'rollup': {
+            const rollup = prop.rollup;
+            if (rollup.type === 'array' && rollup.array) {
+                return rollup.array.flatMap((item) => simplifyPropertyValue(item)).filter((p) => p !== undefined);
+            }
+            return rollup[rollup.type];
+        }
+        case 'url':
+            return prop.url;
+        case 'email':
+            return prop.email;
+        case 'phone_number':
+            return prop.phone_number;
+        default:
+            return undefined;
+    }
+};
+/**
+ * Takes an array of Notion page objects from the API and converts them into
+ * a simplified, flat array of key-value objects.
+ * @param pages The array of page objects from the Notion API response.
+ * @returns An array of simplified page objects.
+ */
+export const simplifyNotionPages = (pages) => {
+    return pages.map((page) => {
+        const simplifiedPage = {};
+        if ('icon' in page) {
+            if (page.icon?.type === 'emoji') {
+                simplifiedPage.icon = page.icon.emoji;
+            }
+            else if (page.icon?.type === 'external') {
+                simplifiedPage.icon = page.icon.external.url;
+            }
+        }
+        if ('cover' in page) {
+            if (page.cover?.type === 'external') {
+                simplifiedPage.cover = page.cover.external.url;
+            }
+            else if (page.cover?.type === 'file') {
+                simplifiedPage.cover = page.cover.file.url;
+            }
+        }
+        simplifiedPage.url = 'url' in page ? page.url : undefined;
+        if ('properties' in page && page.properties) {
+            for (const [propName, propValue] of Object.entries(page.properties)) {
+                simplifiedPage[propName] = simplifyPropertyValue(propValue);
+            }
+        }
+        return simplifiedPage;
+    });
+};
+//# sourceMappingURL=parser.js.map

package/dist/lib/parser.js.map

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

package/dist/lib/property-parser.d.ts

@@ -0,0 +1,25 @@
+import { type CreatePageParameters, type UpdatePageParameters } from '@notionhq/client';
+import { type DataSourceObjectResponse } from '@notionhq/client/build/src/api-endpoints.js';
+type DataSourceSchema = DataSourceObjectResponse['properties'];
+type NotionProperties = CreatePageParameters['properties'];
+/**
+ * Parses a flat properties object from the 'create-pages' tool input
+ * into the format required by the Notion API.
+ *
+ * It uses the data source schema to correctly format each property
+ * according to its type (e.g., number, select, date) [11].
+ *
+ * @param properties - A flat key-value map of properties from the tool input [1].
+ * @param dataSourceSchema - The schema of the parent data source, used to determine property types [6].
+ * @returns A Notion `CreatePageParameters['properties']` object ready for the API [9].
+ */
+export declare function parsePropertiesForCreate(properties: Record<string, string | number | boolean | null>, dataSourceSchema?: DataSourceSchema): NotionProperties;
+/**
+ * Parses a flat properties object with special keys (e.g., 'date:deadline:start')
+ * from the 'update-page' tool input into the format required by the Notion API.
+ * @param properties - A flat key-value map with special-cased keys.
+ * @returns A Notion `UpdatePageParameters['properties']` object.
+ */
+export declare function parsePropertiesForUpdate(_properties: Record<string, string | number>): UpdatePageParameters['properties'];
+export {};
+//# sourceMappingURL=property-parser.d.ts.map

package/dist/lib/property-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-parser.d.ts","sourceRoot":"","sources":["../../src/lib/property-parser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,oBAAoB,EAAE,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AACvF,OAAO,EAAE,KAAK,wBAAwB,EAAE,MAAM,6CAA6C,CAAA;AAE3F,KAAK,gBAAgB,GAAG,wBAAwB,CAAC,YAAY,CAAC,CAAA;AAC9D,KAAK,gBAAgB,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAA;AAE1D;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,EAC5D,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,gBAAgB,CA2FlB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAC3C,oBAAoB,CAAC,YAAY,CAAC,CAMpC"}

package/dist/lib/property-parser.js

@@ -0,0 +1,113 @@
+import { logger } from '@mcp-monorepo/shared';
+/**
+ * Parses a flat properties object from the 'create-pages' tool input
+ * into the format required by the Notion API.
+ *
+ * It uses the data source schema to correctly format each property
+ * according to its type (e.g., number, select, date) [11].
+ *
+ * @param properties - A flat key-value map of properties from the tool input [1].
+ * @param dataSourceSchema - The schema of the parent data source, used to determine property types [6].
+ * @returns A Notion `CreatePageParameters['properties']` object ready for the API [9].
+ */
+export function parsePropertiesForCreate(properties, dataSourceSchema) {
+    const notionProperties = {};
+    // Find the name of the 'title' property from the schema, if it exists [11].
+    const titleSchemaKey = dataSourceSchema
+        ? Object.keys(dataSourceSchema).find((key) => dataSourceSchema[key]?.type === 'title')
+        : 'title';
+    for (const [key, value] of Object.entries(properties)) {
+        // eslint-disable-next-line no-restricted-syntax -- User input
+        if (value === null || value === undefined)
+            continue;
+        // For convenience, allow 'title' as a key and map it to the actual title property name [1].
+        if (key.toLowerCase() === 'title' && titleSchemaKey) {
+            notionProperties[titleSchemaKey] = {
+                title: [{ text: { content: String(value) } }],
+            };
+            continue;
+        }
+        // If no schema is available (e.g., for a workspace page), only the 'title' is valid [9].
+        if (!dataSourceSchema) {
+            if (key.toLowerCase() === 'title') {
+                notionProperties[key] = { title: [{ text: { content: String(value) } }] };
+            }
+            else {
+                logger.warn(`Skipping property "${key}"; only 'title' is allowed for pages not in a database.`);
+            }
+            continue;
+        }
+        const schema = dataSourceSchema[key];
+        if (!schema) {
+            logger.warn(`Skipping property "${key}" as it was not found in the data source schema.`);
+            continue;
+        }
+        // Format the property based on its type from the schema [11].
+        switch (schema.type) {
+            case 'title':
+                notionProperties[key] = { title: [{ text: { content: String(value) } }] };
+                break;
+            case 'rich_text':
+                notionProperties[key] = { rich_text: [{ text: { content: String(value) } }] };
+                break;
+            case 'number':
+                notionProperties[key] = { number: Number(value) };
+                break;
+            case 'select':
+                notionProperties[key] = { select: { name: String(value) } };
+                break;
+            case 'status':
+                notionProperties[key] = { status: { name: String(value) } };
+                break;
+            case 'multi_select':
+                notionProperties[key] = {
+                    multi_select: String(value)
+                        .split(',')
+                        .map((name) => ({ name: name.trim() })),
+                };
+                break;
+            case 'date':
+                notionProperties[key] = { date: { start: String(value) } };
+                break;
+            case 'checkbox': {
+                const lowerValue = String(value).toLowerCase();
+                const boolValue = lowerValue === 'true' || lowerValue === 'yes' || value === 1 || value === true;
+                notionProperties[key] = { checkbox: boolValue };
+                break;
+            }
+            case 'url':
+                notionProperties[key] = { url: String(value) };
+                break;
+            case 'email':
+                notionProperties[key] = { email: String(value) };
+                break;
+            case 'phone_number':
+                notionProperties[key] = { phone_number: String(value) };
+                break;
+            // Advanced types like relation, people, and files are complex and would require
+            // more specific input formats than string/number, often needing IDs.
+            // They are omitted here but can be extended if the tool input is enhanced.
+            case 'relation':
+            case 'people':
+            case 'files':
+            default:
+                logger.warn(`Unsupported property type "${schema.type}" for key "${key}" during creation.`);
+                break;
+        }
+    }
+    return notionProperties;
+}
+/**
+ * Parses a flat properties object with special keys (e.g., 'date:deadline:start')
+ * from the 'update-page' tool input into the format required by the Notion API.
+ * @param properties - A flat key-value map with special-cased keys.
+ * @returns A Notion `UpdatePageParameters['properties']` object.
+ */
+export function parsePropertiesForUpdate(_properties) {
+    // This function would contain the complex logic to handle formats like:
+    // "date:deadline:start", "place:office:name", "__YES__" for checkboxes etc.
+    // It is a placeholder for now.
+    logger.warn('parsePropertiesForUpdate is a skeleton and not fully implemented.');
+    return {};
+}
+//# sourceMappingURL=property-parser.js.map

package/dist/lib/property-parser.js.map

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

package/dist/lib/response-formatter.d.ts

@@ -0,0 +1,16 @@
+import { type BlockObjectResponse, type DatabaseObjectResponse, type DataSourceObjectResponse, type PageObjectResponse } from '@notionhq/client/build/src/api-endpoints.js';
+/**
+ * Formats a Notion Page object and its content into a single Markdown string [5].
+ * @param page - The fetched Page object from the Notion API.
+ * @param blocks - The content blocks of the page.
+ * @returns A promise that resolves to a comprehensive Markdown string representing the page.
+ */
+export declare function formatPageToMarkdown(page: PageObjectResponse, blocks: BlockObjectResponse[]): Promise<string>;
+/**
+ * Formats a Notion Database object and its data sources into a Markdown string that describes its schemas [10].
+ * @param database - The fetched Database object from the Notion API.
+ * @param data_sources - An array of fetched Data Source objects belonging to the database.
+ * @returns A promise that resolves to a Markdown string representing the database and its data source schemas.
+ */
+export declare function formatDatabaseToMarkdown(database: DatabaseObjectResponse, data_sources: DataSourceObjectResponse[]): Promise<string>;
+//# sourceMappingURL=response-formatter.d.ts.map

package/dist/lib/response-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-formatter.d.ts","sourceRoot":"","sources":["../../src/lib/response-formatter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACxB,MAAM,6CAA6C,CAAA;AAoGpD;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBnH;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,sBAAsB,EAChC,YAAY,EAAE,wBAAwB,EAAE,GACvC,OAAO,CAAC,MAAM,CAAC,CA8CjB"}

package/dist/lib/response-formatter.js

@@ -0,0 +1,173 @@
+import { notionToMarkdown } from './markdown-converter.js';
+/**
+ * Formats a single Notion page property into a readable string based on its type [2].
+ * @param name - The name of the property.
+ * @param prop - The property value object from the Notion API.
+ * @returns A formatted string representing the property's value.
+ */
+function formatPageProperty(name, prop) {
+    let value = 'Unsupported type';
+    switch (prop.type) {
+        case 'title':
+            value = prop.title.map((t) => t.plain_text).join('');
+            break;
+        case 'rich_text':
+            value = prop.rich_text.map((t) => t.plain_text).join('');
+            break;
+        case 'number':
+            value = prop.number;
+            break;
+        case 'select':
+            value = prop.select?.name;
+            break;
+        case 'multi_select':
+            value = prop.multi_select.map((s) => s.name).join(', ');
+            break;
+        case 'status':
+            value = prop.status?.name;
+            break;
+        case 'date':
+            if (prop.date) {
+                value = prop.date.end ? `${prop.date.start} -> ${prop.date.end}` : prop.date.start;
+            }
+            else {
+                value = undefined;
+            }
+            break;
+        case 'people':
+            value = prop.people.map((p) => ('name' in p ? p.name : p.id)).join(', ');
+            break;
+        case 'files':
+            value = prop.files.map((f) => f.name).join(', ');
+            break;
+        case 'checkbox':
+            value = prop.checkbox ? 'Yes' : 'No';
+            break;
+        case 'url':
+            value = prop.url;
+            break;
+        case 'email':
+            value = prop.email;
+            break;
+        case 'phone_number':
+            value = prop.phone_number;
+            break;
+        case 'formula': {
+            const { formula } = prop;
+            if (formula.type === 'string')
+                value = formula.string;
+            if (formula.type === 'number')
+                value = formula.number;
+            if (formula.type === 'boolean')
+                value = formula.boolean ? 'Yes' : 'No';
+            if (formula.type === 'date')
+                value = formula.date?.start;
+            break;
+        }
+        case 'relation':
+            value = `${prop.relation.length} relation(s)`;
+            break;
+        case 'created_time':
+            value = new Date(prop.created_time).toLocaleString();
+            break;
+        case 'last_edited_time':
+            value = new Date(prop.last_edited_time).toLocaleString();
+            break;
+        case 'created_by':
+            value = 'id' in prop.created_by ? prop.created_by.id : '';
+            break;
+        case 'last_edited_by':
+            value = 'id' in prop.last_edited_by ? prop.last_edited_by.id : '';
+            break;
+        case 'rollup': {
+            const rollup = prop.rollup;
+            if (rollup.type === 'number')
+                value = rollup.number;
+            else if (rollup.type === 'date')
+                value = rollup.date?.start;
+            else if (rollup.type === 'array')
+                value = `${rollup.array.length} items`;
+            else
+                value = `Unsupported rollup type`;
+            break;
+        }
+        case 'unique_id':
+            value = prop.unique_id.prefix ? `${prop.unique_id.prefix}-${prop.unique_id.number}` : `${prop.unique_id.number}`;
+            break;
+    }
+    // eslint-disable-next-line no-restricted-syntax
+    return `- **${name}**: ${value ?? 'null'}`;
+}
+/**
+ * Formats a Notion Page object and its content into a single Markdown string [5].
+ * @param page - The fetched Page object from the Notion API.
+ * @param blocks - The content blocks of the page.
+ * @returns A promise that resolves to a comprehensive Markdown string representing the page.
+ */
+export async function formatPageToMarkdown(page, blocks) {
+    const contentMarkdown = await notionToMarkdown(blocks);
+    const propertiesMarkdown = Object.entries(page.properties)
+        .map(([name, prop]) => formatPageProperty(name, prop))
+        .join('\n');
+    const icon = page.icon?.type === 'emoji' ? `${page.icon.emoji} ` : '';
+    return `
+# ${icon}Page: ${page.url}
+
+## Properties
+${propertiesMarkdown}
+
+## Content
+---
+${contentMarkdown}
+  `.trim();
+}
+/**
+ * Formats a Notion Database object and its data sources into a Markdown string that describes its schemas [10].
+ * @param database - The fetched Database object from the Notion API.
+ * @param data_sources - An array of fetched Data Source objects belonging to the database.
+ * @returns A promise that resolves to a Markdown string representing the database and its data source schemas.
+ */
+export async function formatDatabaseToMarkdown(database, data_sources) {
+    const title = database.title.map((t) => t.plain_text).join('');
+    const icon = database.icon?.type === 'emoji' ? `${database.icon.emoji} ` : '';
+    const dataSourcesMarkdown = data_sources
+        .map((ds) => {
+        const dsTitle = ds.title.map((t) => t.plain_text).join('');
+        const propertiesMarkdown = Object.entries(ds.properties)
+            .map(([name, prop]) => {
+            let details = `(type: \`${prop.type}\`, id: \`${prop.id}\`)`;
+            let options = [];
+            // For select, multi_select, and status, list the available options [13].
+            if (prop.type === 'select') {
+                options = prop.select.options;
+            }
+            else if (prop.type === 'multi_select') {
+                options = prop.multi_select.options;
+            }
+            else if (prop.type === 'status') {
+                options = prop.status.options;
+            }
+            if (options.length > 0) {
+                const optionsString = options.map((o) => o.name).join(', ');
+                details += `\n    - Options: ${optionsString}`;
+            }
+            return `  - **${name}** ${details}`;
+        })
+            .join('\n');
+        return `
+### Data Source: ${dsTitle}
+> To query this data source, use its URL: collection://${ds.id}
+
+**Schema / Properties:**
+${propertiesMarkdown}
+      `.trim();
+    })
+        .join('\n\n');
+    return `
+# ${icon}Database: ${title}
+> To query pages from this database, use one of the data source URLs below.
+
+${dataSourcesMarkdown}
+  `.trim();
+}
+//# sourceMappingURL=response-formatter.js.map

package/dist/lib/response-formatter.js.map

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

package/dist/tools/create-pages.d.ts

@@ -0,0 +1,3 @@
+import { type McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const registerCreatePagesTool: (server: McpServer) => void;
+//# sourceMappingURL=create-pages.d.ts.map

package/dist/tools/create-pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-pages.d.ts","sourceRoot":"","sources":["../../src/tools/create-pages.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAqExE,eAAO,MAAM,uBAAuB,GAAI,QAAQ,SAAS,SAwIrD,CAAA"}

package/dist/tools/create-pages.js

@@ -0,0 +1,183 @@
+import { registerTool } from '@mcp-monorepo/shared';
+import { markdownToBlocks } from '@tryfabric/martian';
+import { z } from 'zod';
+import { getNotionClient } from '../lib/client.js';
+import { normalizeId } from '../lib/id-utils.js';
+import { parsePropertiesForCreate } from '../lib/property-parser.js';
+// The description is an exact copy of the provided tool definition [1].
+const description = `Creates one or more Notion pages with specified properties and content.
+Use "create-pages" when you need to create one or more new pages that don't exist yet.
+Always include a title property under \`properties\` in each entry of the \`pages\` array.
+Otherwise, the page title will appear blank even if the page content is populated. Don't
+duplicate the page title at the top of the page's \`content\`.
+When creating pages under a Notion database, the property names must match the database's
+schema. Use the "fetch" tool with a Notion database URL to get the database schema. Or, look
+for existing pages under the database using the "search" tool then use the "fetch" tool to see
+the names of the property keys. One exception is the "title" property, which all pages have,
+but can be named differently in the schema of a database. For convenience, you can use the
+generic property name "title" in the "properties" object, and it will automatically be
+re-mapped to the actual name of the title property in the database schema when creating the
+page.
+All pages created with a single call to this tool will have the same parent.
+The parent can be a Notion page or database. If the parent is omitted, the pages will be
+created as standalone, workspace-level private pages and the person that created them
+can organize them as they see fit later.
+IMPORTANT: When specifying a parent database, use the appropriate ID format:
+- Use "data_source_id" when you have a collection:// URL from the fetch tool (this is the most common case)
+- Use "database_id" when you have a page URL for a database view (less common)
+- Use "page_id" when the parent is a regular page
+Examples of creating pages:
+1. Create a standalone page with a title and content:
+{
+"pages": [
+{
+"properties": {"title":"Page title"},
+"content": "# Section 1\\nSection 1 content\\n# Section 2\\nSection 2 content"
+}
+]
+}
+2. Create a page under a database's data source (collection), e.g. using an ID from a collection:// URL provided by the fetch tool:
+{
+"parent": {"data_source_id": "f336d0bc-b841-465b-8045-024475c079dd"},
+"pages": [
+{
+"properties": {
+"Task Name": "Task 123",
+"Status": "In Progress",
+},
+},
+],
+}
+3. Create a page with an existing page as a parent:
+{
+"parent": {"page_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"},
+"pages": [
+{
+"properties": {"title": "Page title"},
+"content": "# Section 1\\nSection 1 content\\n# Section 2\\nSection 2 content"
+}
+]
+}`;
+export const registerCreatePagesTool = (server) => registerTool(server, {
+    name: 'notion-create-pages',
+    title: 'Create pages in Markdown',
+    description,
+    inputSchema: {
+        pages: z
+            .array(z
+            .object({
+            content: z.string().describe('The content of the new page, using Notion Markdown.').optional(),
+            properties: z
+                .record(z.union([z.string(), z.number(), z.null()]))
+                .describe('The properties of the new page, which is a JSON map of property names to SQLite values.\nFor pages in a database, use the SQLite schema definition shown in <database>.\nFor pages outside of a database, the only allowed property is "title", which is the title of the page and is automatically shown at the top of the page as a large heading.'),
+        })
+            .strict())
+            .max(100)
+            .describe('The pages to create.'),
+        parent: z
+            .union([
+            z
+                .object({
+                type: z.literal('page_id').optional(),
+                page_id: z
+                    .string()
+                    .describe('The ID of the parent page (with or without dashes), for example, 195de9221179449fab8075a27c979105'),
+            })
+                .strict(),
+            z
+                .object({
+                type: z.literal('database_id').optional(),
+                database_id: z
+                    .string()
+                    .describe('The ID of the parent database (with or without dashes), for example, 195de9221179449fab8075a27c979105'),
+            })
+                .strict(),
+            z
+                .object({
+                type: z.literal('data_source_id').optional(),
+                data_source_id: z
+                    .string()
+                    .describe('The ID of the parent data source (collection), with or without dashes. For example, f336d0bc-b841-465b-8045-024475c079dd'),
+            })
+                .strict(),
+        ])
+            .optional()
+            .describe('The parent under which the new pages will be created. This can be a page (page_id), a database page (database_id), or a data source/collection under a database (data_source_id). If omitted, the new pages will be created as private pages at the workspace level. Use data_source_id when you have a collection:// URL from the fetch tool.'),
+    },
+    outputSchema: {
+        created_pages: z
+            .array(z.object({
+            page_id: z.string(),
+            url: z.string(),
+            title: z.string().optional(),
+        }))
+            .describe('A list of the pages that were successfully created.'),
+    },
+    async fetcher(args) {
+        const notion = getNotionClient();
+        const { pages, parent } = args;
+        let apiParent;
+        let dataSourceSchema;
+        if (!parent) {
+            // To create a page at the workspace level, the parent must be `{ workspace: true }` [2, 1].
+            apiParent = { workspace: true };
+        }
+        else if ('data_source_id' in parent && parent.data_source_id) {
+            const id = normalizeId(parent.data_source_id);
+            if (!id)
+                throw new Error(`Invalid data_source_id: ${parent.data_source_id}`);
+            const dataSource = (await notion.dataSources.retrieve({ data_source_id: id }));
+            apiParent = { database_id: dataSource.parent.database_id };
+            dataSourceSchema = dataSource.properties;
+        }
+        else if ('database_id' in parent && parent.database_id) {
+            const id = normalizeId(parent.database_id);
+            if (!id)
+                throw new Error(`Invalid database_id: ${parent.database_id}`);
+            const database = (await notion.databases.retrieve({ database_id: id }));
+            const firstDataSourceId = database.data_sources[0]?.id;
+            if (!firstDataSourceId)
+                throw new Error(`Database ${parent.database_id} has no data sources.`);
+            const dataSource = (await notion.dataSources.retrieve({
+                data_source_id: firstDataSourceId,
+            }));
+            apiParent = { database_id: dataSource.parent.database_id };
+            dataSourceSchema = dataSource.properties;
+        }
+        else if ('page_id' in parent && parent.page_id) {
+            const id = normalizeId(parent.page_id);
+            if (!id)
+                throw new Error(`Invalid page_id: ${parent.page_id}`);
+            apiParent = { page_id: id };
+        }
+        else {
+            throw new Error('Invalid parent object provided.');
+        }
+        const createPagePromises = pages.map(async (page) => {
+            const children = page.content ? markdownToBlocks(page.content) : undefined;
+            const notionProperties = parsePropertiesForCreate(page.properties, dataSourceSchema);
+            const newPage = await notion.pages.create({
+                parent: apiParent,
+                properties: notionProperties,
+                children,
+            });
+            return newPage;
+        });
+        return Promise.all(createPagePromises);
+    },
+    async formatter(createdPages) {
+        const results = createdPages.map((page) => {
+            const titleProperty = Object.values(page.properties).find((p) => p.type === 'title');
+            const title = titleProperty && 'title' in titleProperty && titleProperty.title.length > 0
+                ? titleProperty.title[0].plain_text
+                : 'Untitled';
+            return {
+                page_id: page.id,
+                url: page.url,
+                title,
+            };
+        });
+        return { created_pages: results };
+    },
+});
+//# sourceMappingURL=create-pages.js.map

package/dist/tools/create-pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-pages.js","sourceRoot":"","sources":["../../src/tools/create-pages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAQnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA;AAEpE,wEAAwE;AACxE,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoDlB,CAAA;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,MAAiB,EAAE,EAAE,CAC3D,YAAY,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,qBAAqB;IAC3B,KAAK,EAAE,0BAA0B;IACjC,WAAW;IACX,WAAW,EAAE;QACX,KAAK,EAAE,CAAC;aACL,KAAK,CACJ,CAAC;aACE,MAAM,CAAC;YACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC,CAAC,QAAQ,EAAE;YAC9F,UAAU,EAAE,CAAC;iBACV,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;iBACnD,QAAQ,CACP,sVAAsV,CACvV;SACJ,CAAC;aACD,MAAM,EAAE,CACZ;aACA,GAAG,CAAC,GAAG,CAAC;aACR,QAAQ,CAAC,sBAAsB,CAAC;QACnC,MAAM,EAAE,CAAC;aACN,KAAK,CAAC;YACL,CAAC;iBACE,MAAM,CAAC;gBACN,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE;gBACrC,OAAO,EAAE,CAAC;qBACP,MAAM,EAAE;qBACR,QAAQ,CACP,mGAAmG,CACpG;aACJ,CAAC;iBACD,MAAM,EAAE;YACX,CAAC;iBACE,MAAM,CAAC;gBACN,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;gBACzC,WAAW,EAAE,CAAC;qBACX,MAAM,EAAE;qBACR,QAAQ,CACP,uGAAuG,CACxG;aACJ,CAAC;iBACD,MAAM,EAAE;YACX,CAAC;iBACE,MAAM,CAAC;gBACN,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE;gBAC5C,cAAc,EAAE,CAAC;qBACd,MAAM,EAAE;qBACR,QAAQ,CACP,0HAA0H,CAC3H;aACJ,CAAC;iBACD,MAAM,EAAE;SACZ,CAAC;aACD,QAAQ,EAAE;aACV,QAAQ,CACP,gVAAgV,CACjV;KACJ;IACD,YAAY,EAAE;QACZ,aAAa,EAAE,CAAC;aACb,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;YACnB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;YACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC7B,CAAC,CACH;aACA,QAAQ,CAAC,qDAAqD,CAAC;KACnE;IACD,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,MAAM,GAAG,eAAe,EAAE,CAAA;QAChC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;QAE9B,IAAI,SAAyC,CAAA;QAC7C,IAAI,gBAAoE,CAAA;QAExE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,4FAA4F;YAC5F,SAAS,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAA;QACjC,CAAC;aAAM,IAAI,gBAAgB,IAAI,MAAM,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;YAC/D,MAAM,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,cAAc,CAAC,CAAA;YAC7C,IAAI,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,CAAC,cAAc,EAAE,CAAC,CAAA;YAC5E,MAAM,UAAU,GAAG,CAAC,MAAM,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,CAA6B,CAAA;YAC1G,SAAS,GAAG,EAAE,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC,WAAW,EAAE,CAAA;YAC1D,gBAAgB,GAAG,UAAU,CAAC,UAAU,CAAA;QAC1C,CAAC;aAAM,IAAI,aAAa,IAAI,MAAM,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACzD,MAAM,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;YAC1C,IAAI,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAA;YACtE,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAA2B,CAAA;YACjG,MAAM,iBAAiB,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;YACtD,IAAI,CAAC,iBAAiB;gBAAE,MAAM,IAAI,KAAK,CAAC,YAAY,MAAM,CAAC,WAAW,uBAAuB,CAAC,CAAA;YAC9F,MAAM,UAAU,GAAG,CAAC,MAAM,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC;gBACpD,cAAc,EAAE,iBAAiB;aAClC,CAAC,CAA6B,CAAA;YAC/B,SAAS,GAAG,EAAE,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC,WAAW,EAAE,CAAA;YAC1D,gBAAgB,GAAG,UAAU,CAAC,UAAU,CAAA;QAC1C,CAAC;aAAM,IAAI,SAAS,IAAI,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACjD,MAAM,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;YACtC,IAAI,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAA;YAC9D,SAAS,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,CAAA;QAC7B,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;QACpD,CAAC;QAED,MAAM,kBAAkB,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAE,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAA0B,CAAC,CAAC,CAAC,SAAS,CAAA;YACpG,MAAM,gBAAgB,GAAG,wBAAwB,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAA;YAEpF,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;gBACxC,MAAM,EAAE,SAAS;gBACjB,UAAU,EAAE,gBAAgB;gBAC5B,QAAQ;aACT,CAAC,CAAA;YACF,OAAO,OAA6B,CAAA;QACtC,CAAC,CAAC,CAAA;QAEF,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAA;IACxC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,YAAY;QAC1B,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACxC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAA;YACpF,MAAM,KAAK,GACT,aAAa,IAAI,OAAO,IAAI,aAAa,IAAI,aAAa,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;gBACzE,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU;gBACnC,CAAC,CAAC,UAAU,CAAA;YAEhB,OAAO;gBACL,OAAO,EAAE,IAAI,CAAC,EAAE;gBAChB,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,KAAK;aACN,CAAA;QACH,CAAC,CAAC,CAAA;QACF,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,CAAA;IACnC,CAAC;CACF,CAAC,CAAA"}

package/dist/tools/fetch.d.ts

@@ -0,0 +1,3 @@
+import { type McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const registerFetchTool: (server: McpServer) => void;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/tools/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/tools/fetch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAuBxE,eAAO,MAAM,iBAAiB,GAAI,QAAQ,SAAS,SA4F/C,CAAA"}

package/dist/tools/fetch.js

@@ -0,0 +1,89 @@
+import { registerTool } from '@mcp-monorepo/shared';
+import { z } from 'zod';
+import { getNotionClient } from '../lib/client.js';
+import { normalizeId } from '../lib/id-utils.js';
+import { formatDatabaseToMarkdown, formatPageToMarkdown } from '../lib/response-formatter.js';
+export const registerFetchTool = (server) => registerTool(server, {
+    name: 'fetch',
+    title: 'Fetch Notion entities',
+    description: `Retrieves details about a Notion entity by its URL or ID.
+You can fetch the following types of entities:
+- Page, i.e. from a <page> block or a <mention-page> mention
+- Database, i.e. from a <database> block or a <mention-database> mention
+Use the "fetch" tool when you need to see the details of a Notion entity you already know
+exists and have its URL or ID.
+Provide the Notion entity's URL or ID in the \`id\` parameter. You must make multiple calls
+to the "fetch" tool if you want to fetch multiple entities.
+Content for pages that are returned use the enhanced Markdown format, which is a superset of
+the standard Markdown syntax. See the full spec in the description of the "create-pages"
+tool.
+Databases can have multiple data sources, which are collections of pages with the same schema.
+When fetching a database, the tool will return information about all its data sources.
+Examples of fetching entities:
+1. Fetch a page by URL:
+{
+"id": "https://www.notion.so/workspace/Product-Requirements-1234567890abcdef"
+}
+2. Fetch a page by ID (UUIDv4 with dashes):
+{
+"id": "12345678-90ab-cdef-1234-567890abcdef"
+}
+3. Fetch a page by ID (UUIDv4 without dashes):
+{
+"id": "1234567890abcdef1234567890abcdef"
+}
+4. Fetch a database:
+{
+"id": "https://www.notion.so/workspace/Projects-Database-abcdef1234567890"
+}
+Common use cases:
+- "What are the product requirements still need to be implemented from this ticket
+https://notion.so/page-url?"
+- "Show me the details of the project database at this URL"
+- "Get the content of page 12345678-90ab-cdef-1234-567890abcdef"`,
+    isReadOnly: true,
+    inputSchema: {
+        id: z.string().describe('The ID or URL of the Notion page or database to fetch.'),
+    },
+    outputSchema: {
+        markdown: z.string(),
+    },
+    async fetcher(args) {
+        const notion = getNotionClient();
+        const entityId = normalizeId(args.id);
+        if (!entityId) {
+            throw new Error(`Invalid Notion ID or URL: ${args.id}`);
+        }
+        try {
+            const page = await notion.pages.retrieve({ page_id: entityId });
+            const blocks = await notion.blocks.children.list({ block_id: entityId });
+            return { type: 'page', page, blocks };
+        }
+        catch (pageError) {
+            try {
+                const databaseResponse = (await notion.databases.retrieve({
+                    database_id: entityId,
+                }));
+                // A database contains references to its data sources. We need to fetch each one to get the schema.
+                const dataSourcePromises = (databaseResponse.data_sources || []).map((ds) => notion.dataSources.retrieve({ data_source_id: ds.id }));
+                const data_sources = await Promise.all(dataSourcePromises);
+                return { type: 'database', database: databaseResponse, data_sources };
+            }
+            catch (dbError) {
+                throw new Error(`Could not fetch '${entityId}' as a page or database.`);
+            }
+        }
+    },
+    async formatter(data) {
+        if (data.type === 'page') {
+            return {
+                markdown: await formatPageToMarkdown(data.page, data.blocks.results),
+            };
+        }
+        // Pass both the database and its full data_sources to the formatter.
+        return {
+            markdown: await formatDatabaseToMarkdown(data.database, data.data_sources),
+        };
+    },
+});
+//# sourceMappingURL=fetch.js.map

package/dist/tools/fetch.js.map

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

package/dist/tools/query-datasource.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const registerQueryDatasourceTool: (server: McpServer) => void;
+//# sourceMappingURL=query-datasource.d.ts.map

package/dist/tools/query-datasource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-datasource.d.ts","sourceRoot":"","sources":["../../src/tools/query-datasource.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,eAAO,MAAM,2BAA2B,GAAI,QAAQ,SAAS,SA6EzD,CAAA"}

package/dist/tools/{notion-query.js → query-datasource.js}

@@ -1,9 +1,11 @@
 import { registerTool } from '@mcp-monorepo/shared';
 import { z } from 'zod';
-export const registerNotionQueryTool = (server) => registerTool(server, {
-    name: 'notion-query',
+import { getNotionClient } from '../lib/client.js';
+import { simplifyNotionPages } from '../lib/parser.js';
+export const registerQueryDatasourceTool = (server) => registerTool(server, {
+    name: 'query-datasource',
     title: 'Query a Notion Data Source',
-    description: `Gets a list of pages from a data source, identified by its URL (e.g., "collection://<uuid>"). Supports filtering and sorting. The response is paginated; use 'start_cursor' for subsequent requests if 'next_cursor' is returned. Filters operate on properties and can be simple or compound (using "and"/"or"). Sorts operate on properties or timestamps. For performance, use 'filter_properties' to retrieve only necessary page properties. Refer to Notion API documentation for the exact filter and sort object structures.`,
+    description: `Gets a list of pages from a data source, identified by its URL (e.g., "collection://<uuid>"). Supports filtering and sorting. The response is paginated; use 'start_cursor' for subsequent requests if 'next_cursor' is returned. Filters operate on properties and can be simple or compound (using "and"/"or"). Sorts operate on properties or timestamps. For performance, you can use 'filter_properties' to retrieve only necessary page properties. Refer to Notion API documentation for the exact filter and sort object structures.`,
     inputSchema: {
         data_source_url: z
             .string()
@@ -13,7 +15,11 @@ export const registerNotionQueryTool = (server) => registerTool(server, {
             .optional()
             .describe('A JSON filter object to apply. Example: {"property": "Done", "checkbox": {"equals": true}} or {"and": [...]}.'),
         sorts: z
-            .array(z.record(z.string(), z.unknown()))
+            .array(z.object({
+            property: z.string().optional(),
+            timestamp: z.string().optional(),
+            direction: z.enum(['ascending', 'descending']),
+        }))
             .optional()
             .describe('An array of JSON sort objects. Example: [{"property": "Name", "direction": "ascending"}].'),
         start_cursor: z.string().optional().describe('If provided, starts the query at the specified cursor.'),
@@ -24,7 +30,9 @@ export const registerNotionQueryTool = (server) => registerTool(server, {
             .describe('An array of property IDs or names to return. If not provided, all properties are returned.'),
     },
     outputSchema: {
-        results: z.array(z.any()).describe('An array of page objects matching the query.'),
+        results: z
+            .array(z.record(z.string(), z.any()))
+            .describe('An array of simplified page objects. Each object is a flat key-value map of its properties.'),
         next_cursor: z
             .string()
             .nullable()
@@ -37,47 +45,32 @@ export const registerNotionQueryTool = (server) => registerTool(server, {
         if (!data_source_url?.startsWith('collection://')) {
             throw new Error('Invalid data_source_url format. Must start with "collection://".');
         }
+        const notion = getNotionClient();
         const dataSourceId = data_source_url.substring('collection://'.length);
-        const NOTION_API_KEY = process.env.NOTION_API_KEY;
-        if (!NOTION_API_KEY) {
-            throw new Error('NOTION_API_KEY environment variable is not set.');
-        }
-        const apiUrl = new URL(`https://api.notion.com/v1/data_sources/${dataSourceId}/query`);
-        if (filter_properties && filter_properties.length > 0) {
-            filter_properties.forEach((prop) => {
-                apiUrl.searchParams.append('filter_properties', prop);
+        try {
+            return await notion.dataSources.query({
+                data_source_id: dataSourceId,
+                filter: filter,
+                sorts: sorts,
+                start_cursor,
+                page_size,
+                filter_properties,
             });
         }
-        const body = {};
-        if (filter)
-            body.filter = filter;
-        if (sorts)
-            body.sorts = sorts;
-        if (start_cursor)
-            body.start_cursor = start_cursor;
-        if (page_size)
-            body.page_size = page_size;
-        const response = await fetch(apiUrl.toString(), {
-            method: 'POST',
-            headers: {
-                Authorization: `Bearer ${NOTION_API_KEY}`,
-                'Notion-Version': '2025-09-03',
-                'Content-Type': 'application/json',
-            },
-            body: Object.keys(body).length > 0 ? JSON.stringify(body) : undefined,
-        });
-        if (!response.ok) {
-            const errorText = await response.text();
-            throw new Error(`Notion API request failed with status ${response.status}: ${errorText}`);
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Notion API request failed: ${error.message}`);
+            }
+            throw new Error('An unknown Notion API error occurred.');
         }
-        return (await response.json());
     },
+    // The formatter is now extremely clean, just calling the new parser.
     formatter(data) {
         return {
-            results: data.results,
+            results: simplifyNotionPages(data.results),
             next_cursor: data.next_cursor,
             has_more: data.has_more,
         };
     },
 });
-//# sourceMappingURL=notion-query.js.map
+//# sourceMappingURL=query-datasource.js.map

package/dist/tools/query-datasource.js.map

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

package/package.json

@@ -1,13 +1,11 @@
 {
   "name": "@mcp-monorepo/notion-query",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "type": "module",
   "description": "MCP server for querying Notion data sources.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "bin": {
-    "@mcp-monorepo/notion-query": "./dist/index.js"
-  },
+  "bin": "./dist/index.js",
   "files": [
     "dist"
   ],
@@ -25,14 +23,17 @@
     "clean": "rimraf dist tsconfig.tsbuildinfo"
   },
   "dependencies": {
+    "@mcp-monorepo/shared": "workspace:*",
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "zod": "^3.25.76",
-    "@mcp-monorepo/shared": "*"
+    "@notionhq/client": "^5.6.0",
+    "@tryfabric/martian": "^1.2.4",
+    "notion-to-md": "^3.1.9",
+    "zod": "^3.25.76"
   },
   "devDependencies": {
     "@types/node": "^22.14.1",
+    "rimraf": "^6.0.1",
     "typescript": "^5.8.3",
-    "vitest": "^3.2.4",
-    "rimraf": "^6.0.1"
+    "vitest": "^3.2.4"
   }
 }

package/dist/tools/notion-query.d.ts

@@ -1,3 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare const registerNotionQueryTool: (server: McpServer) => void;
-//# sourceMappingURL=notion-query.d.ts.map

package/dist/tools/notion-query.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"notion-query.d.ts","sourceRoot":"","sources":["../../src/tools/notion-query.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,eAAO,MAAM,uBAAuB,GAAI,QAAQ,SAAS,SAuFrD,CAAA"}

package/dist/tools/notion-query.js.map

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