@mcp-monorepo/notion-query 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

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

package/dist/index.js.map

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

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

@@ -0,0 +1,3 @@
+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

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

@@ -0,0 +1,83 @@
+import { registerTool } from '@mcp-monorepo/shared';
+import { z } from 'zod';
+export const registerNotionQueryTool = (server) => registerTool(server, {
+    name: 'notion-query',
+    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.`,
+    inputSchema: {
+        data_source_url: z
+            .string()
+            .describe('The URL of the data source to query, e.g., "collection://f336d0bc-b841-465b-8045-024475c079dd".'),
+        filter: z
+            .any()
+            .optional()
+            .describe('A JSON filter object to apply. Example: {"property": "Done", "checkbox": {"equals": true}} or {"and": [...]}.'),
+        sorts: z
+            .array(z.any())
+            .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.'),
+        page_size: z.number().optional().describe('The number of items to return (max 100).'),
+        filter_properties: z
+            .array(z.string())
+            .optional()
+            .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.'),
+        next_cursor: z
+            .string()
+            .nullable()
+            .describe('The cursor for the next page of results, or null if there are no more results.'),
+        has_more: z.boolean().describe('Whether there are more results available.'),
+    },
+    isReadOnly: true,
+    async fetcher(args) {
+        const { data_source_url, filter, sorts, start_cursor, page_size, filter_properties } = args;
+        if (!data_source_url?.startsWith('collection://')) {
+            throw new Error('Invalid data_source_url format. Must start with "collection://".');
+        }
+        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);
+            });
+        }
+        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}`);
+        }
+        return (await response.json());
+    },
+    formatter(data) {
+        return {
+            results: data.results,
+            next_cursor: data.next_cursor,
+            has_more: data.has_more,
+        };
+    },
+});
+//# sourceMappingURL=notion-query.js.map

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

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

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@mcp-monorepo/notion-query",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "MCP server for querying Notion data sources.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "mcp-npm-server": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist tsconfig.tsbuildinfo"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.25.76",
+    "@mcp-monorepo/shared": "*"
+  },
+  "devDependencies": {
+    "@types/node": "^22.14.1",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4",
+    "rimraf": "^6.0.1"
+  }
+}