@mcp-monorepo/notion-query 1.1.0 → 1.3.0

package/dist/local-rag/watcher.js

@@ -0,0 +1,102 @@
+import { basename, dirname, extname } from 'node:path';
+import { logger } from '@mcp-monorepo/shared';
+import { FSWatcher } from 'chokidar';
+import { TypedEventEmitter } from './utils/typed-emitter.js';
+/**
+ * A robust file system watcher that abstracts away the complexities of chokidar.
+ * It debounces change events and only reports on supported file types, emitting clean,
+ * actionable events. It handles both initial discovery of existing files and
+ * subsequent changes.
+ */
+export class DirectoryWatcher extends TypedEventEmitter {
+    watcher;
+    debounceTimers = new Map();
+    debounceMs;
+    supportedExtensions;
+    constructor(debounceMs, supportedExtensions) {
+        super();
+        this.debounceMs = debounceMs;
+        this.supportedExtensions = new Set(supportedExtensions);
+        this.watcher = new FSWatcher({
+            ignored: /(^|[/\\])\../, // ignore dotfiles and dot folders
+            persistent: true,
+            awaitWriteFinish: true,
+        });
+        this.setupListeners();
+    }
+    setupListeners() {
+        this.watcher
+            .on('add', (path) => this.handleFileEvent(path, 'file-added'))
+            .on('change', (path) => this.handleFileEvent(path, 'file-changed'))
+            .on('unlink', (path) => this.handleFileEvent(path, 'file-deleted'))
+            .on('error', (error) => logger.error(`Watcher error: ${error}`));
+    }
+    isSupported(filePath) {
+        const ext = extname(filePath).toLowerCase();
+        return this.supportedExtensions.has(ext);
+    }
+    handleFileEvent(filePath, event) {
+        if (!this.isSupported(filePath)) {
+            return; // Ignore unsupported file types
+        }
+        // Clear any existing timer to debounce rapid changes
+        if (this.debounceTimers.has(filePath)) {
+            clearTimeout(this.debounceTimers.get(filePath));
+            this.debounceTimers.delete(filePath);
+        }
+        // For deletions, we want to act immediately.
+        if (event === 'file-deleted') {
+            logger.info(`Watcher: Detected deletion for: ${filePath}`);
+            this.emit('file-deleted', filePath);
+            return;
+        }
+        // For adds and changes, debounce the event to avoid churn.
+        const timer = setTimeout(() => {
+            logger.info(`Watcher: Detected ${event === 'file-added' ? 'addition' : 'change'} for: ${filePath}`);
+            this.emit(event, filePath);
+            this.debounceTimers.delete(filePath);
+        }, this.debounceMs);
+        this.debounceTimers.set(filePath, timer);
+    }
+    /**
+     * Checks if a given path is already being watched by chokidar.
+     * @param path The absolute path to check.
+     * @returns True if the path is being watched, false otherwise.
+     */
+    isWatching(path) {
+        const watched = this.watcher.getWatched();
+        // getWatched() returns an object like: { '/path/to/dir': ['file1.txt', 'file2.txt'], '/path/to/other/file.md': [] }
+        const dir = dirname(path);
+        const base = basename(path);
+        return !!watched[path] || watched[dir]?.includes(base);
+    }
+    /**
+     * Starts watching a given path (file or directory).
+     * @param path - The path to watch.
+     */
+    watch(path) {
+        if (this.isWatching(path)) {
+            logger.debug(`Watcher: Already watching ${path}`);
+            return;
+        }
+        this.watcher.add(path);
+    }
+    /**
+     * Stops watching a given path.
+     * @param path - The path to unwatch.
+     */
+    unwatch(path) {
+        this.watcher.unwatch(path);
+    }
+    /**
+     * Gracefully shuts down the watcher, releasing all file system handles.
+     */
+    async close() {
+        for (const timer of this.debounceTimers.values()) {
+            clearTimeout(timer);
+        }
+        this.debounceTimers.clear();
+        await this.watcher.close();
+    }
+}
+//# sourceMappingURL=watcher.js.map

package/dist/local-rag/watcher.js.map

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

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

@@ -0,0 +1,4 @@
+import { type McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { NotionSyncer } from '../lib/notion-syncer.js';
+export declare const registerCreatePagesTool: (server: McpServer, notionSyncer: NotionSyncer) => 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;AAcxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAyD3D,eAAO,MAAM,uBAAuB,GAAI,QAAQ,SAAS,EAAE,cAAc,YAAY,SAyIjF,CAAA"}

package/dist/tools/create-pages.js

@@ -0,0 +1,184 @@
+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, notionSyncer) => registerTool(server, {
+    name: '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) {
+        await Promise.allSettled(createdPages.map((page) => notionSyncer.triggerImmediateSync(page.id)));
+        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":"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"}

package/dist/tools/fetch.d.ts

@@ -0,0 +1,4 @@
+import { type McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { NotionSyncer } from '../lib/notion-syncer.js';
+export declare const registerFetchTool: (server: McpServer, notionSyncer: NotionSyncer) => 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;AAmBxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAM3D,eAAO,MAAM,iBAAiB,GAAI,QAAQ,SAAS,EAAE,cAAc,YAAY,SA6F3E,CAAA"}

package/dist/tools/fetch.js

@@ -0,0 +1,90 @@
+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, notionSyncer) => 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') {
+            await notionSyncer.triggerImmediateSync(data.page.id);
+            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,4 @@
+import type { NotionSyncer } from '../lib/notion-syncer.js';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const registerQueryDatasourceTool: (server: McpServer, notionSyncer: NotionSyncer) => 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,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,eAAO,MAAM,2BAA2B,GAAI,QAAQ,SAAS,EAAE,cAAc,YAAY,SA+ErF,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, notionSyncer) => 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());
     },
-    formatter(data) {
+    async formatter(data) {
+        await Promise.allSettled(data.results.map((pageOrDatasource) => notionSyncer.triggerImmediateSync(pageOrDatasource.id)));
         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/dist/tools/search.d.ts

@@ -0,0 +1,12 @@
+import type { NotionSyncer } from '../lib/notion-syncer.js';
+import type { LocalRAG } from '../local-rag/index.js';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Registers the Notion search tool with the MCP server.
+ * The tool uses a LocalRAG instance for searching and a NotionSyncer for metadata.
+ * @param server - The McpServer instance.
+ * @param localRag - The initialized LocalRAG instance.
+ * @param notionSyncer - The initialized NotionSyncer instance.
+ */
+export declare const registerSearchTool: (server: McpServer, localRag: LocalRAG, notionSyncer: NotionSyncer) => void;
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAYxE;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,SAAS,EAAE,UAAU,QAAQ,EAAE,cAAc,YAAY,SA6EnG,CAAA"}

package/dist/tools/search.js

@@ -0,0 +1,75 @@
+import { registerTool } from '@mcp-monorepo/shared';
+import { z } from 'zod';
+/**
+ * Registers the Notion search tool with the MCP server.
+ * The tool uses a LocalRAG instance for searching and a NotionSyncer for metadata.
+ * @param server - The McpServer instance.
+ * @param localRag - The initialized LocalRAG instance.
+ * @param notionSyncer - The initialized NotionSyncer instance.
+ */
+export const registerSearchTool = (server, localRag, notionSyncer) => {
+    return registerTool(server, {
+        name: 'search',
+        title: 'Search Notion workspace',
+        description: 'Perform a semantic search over your entire Notion workspace.\nYou can use search when you need to find information which is not already available via other tools, and you don\'t know where it\'s located.\nIf initial results do not contain all the information you need, you can try more specific queries.\nAfter obtaining search results, if the user asks for the full contents of a page or database, use the "fetch" tool. This tool only shows some details like a highlight and the URL and title of each search result.',
+        inputSchema: {
+            query: z
+                .string()
+                .min(1)
+                .describe("Semantic search query over your entire Notion workspace. For best results, don't provide more than one question per tool call."),
+            page_url: z
+                .string()
+                .optional()
+                .describe('Optionally, provide the URL or ID of a page to search within. This will perform a semantic search over the content within and under the specified page.'),
+            teamspace_id: z
+                .string()
+                .optional()
+                .describe('Optionally, provide the ID of a teamspace to restrict search results to. This will perform a search over content within the specified teamspace only.'),
+            data_source_url: z
+                .string()
+                .optional()
+                .describe('Optionally, provide the URL of a Data source to search. This will perform a semantic search over the pages in the Data Source.'),
+        },
+        outputSchema: {
+            results: z
+                .array(z.object({
+                title: z.string(),
+                url: z.string().url(),
+                highlight: z.string(),
+                score: z.number(),
+            }))
+                .describe('An array of search results, ordered by relevance (lower score is better).'),
+        },
+        isReadOnly: true,
+        async fetcher(args) {
+            // The core logic is just to query the LocalRAG instance.
+            // We don't need the syncer state here, we'll use it in the formatter.
+            return localRag.query({
+                query: args.query,
+                limit: 5, // Return top 5 results
+            });
+        },
+        async formatter(ragResults) {
+            const syncState = notionSyncer.getSyncState();
+            if (!syncState) {
+                return { results: [] };
+            }
+            const searchResults = [];
+            for (const result of ragResults) {
+                // Extract the page ID from the file path (e.g., '.../content/page-id.md')
+                const pageId = result.filePath.split(/[/\\]/).pop()?.replace('.md', '');
+                if (pageId && syncState.pages[pageId]) {
+                    const pageInfo = syncState.pages[pageId];
+                    searchResults.push({
+                        title: pageInfo.title ?? '<N/A>',
+                        url: pageInfo.url ?? '<N/A>',
+                        highlight: result.text,
+                        score: result.score,
+                    });
+                }
+            }
+            return { results: searchResults };
+        },
+    });
+};
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAkBvB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAiB,EAAE,QAAkB,EAAE,YAA0B,EAAE,EAAE;IACtG,OAAO,YAAY,CAAC,MAAM,EAAE;QAC1B,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,yBAAyB;QAChC,WAAW,EACT,sgBAAsgB;QACxgB,WAAW,EAAE;YACX,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CACP,gIAAgI,CACjI;YACH,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,yJAAyJ,CAC1J;YACH,YAAY,EAAE,CAAC;iBACZ,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,uJAAuJ,CACxJ;YACH,eAAe,EAAE,CAAC;iBACf,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,gIAAgI,CACjI;SACJ;QACD,YAAY,EAAE;YACZ,OAAO,EAAE,CAAC;iBACP,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;gBACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;gBACjB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;gBACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;gBACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;aAClB,CAAC,CACH;iBACA,QAAQ,CAAC,2EAA2E,CAAC;SACzF;QACD,UAAU,EAAE,IAAI;QAChB,KAAK,CAAC,OAAO,CAAC,IAAI;YAChB,yDAAyD;YACzD,sEAAsE;YACtE,OAAO,QAAQ,CAAC,KAAK,CAAC;gBACpB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,KAAK,EAAE,CAAC,EAAE,uBAAuB;aAClC,CAAC,CAAA;QACJ,CAAC;QACD,KAAK,CAAC,SAAS,CAAC,UAAyB;YACvC,MAAM,SAAS,GAAG,YAAY,CAAC,YAAY,EAAE,CAAA;YAC7C,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAA;YACxB,CAAC;YAED,MAAM,aAAa,GAAyB,EAAE,CAAA;YAC9C,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;gBAChC,0EAA0E;gBAC1E,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;gBAEvE,IAAI,MAAM,IAAI,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;oBACtC,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;oBACxC,aAAa,CAAC,IAAI,CAAC;wBACjB,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,OAAO;wBAChC,GAAG,EAAE,QAAQ,CAAC,GAAG,IAAI,OAAO;wBAC5B,SAAS,EAAE,MAAM,CAAC,IAAI;wBACtB,KAAK,EAAE,MAAM,CAAC,KAAK;qBACpB,CAAC,CAAA;gBACJ,CAAC;YACH,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,CAAA;QACnC,CAAC;KACF,CAAC,CAAA;AACJ,CAAC,CAAA"}