notion-mcp-server 1.0.0 → 2.4.2

package/build/prompts/index.js

@@ -0,0 +1,105 @@
+import { z } from "zod";
+import { server } from "../server/index.js";
+function userMessage(text) {
+    return {
+        messages: [
+            {
+                role: "user",
+                content: { type: "text", text },
+            },
+        ],
+    };
+}
+export function registerAllPrompts() {
+    server.registerPrompt("create_task", {
+        title: "Create Notion task",
+        description: "Create a new task page in Notion with optional status and due date.",
+        argsSchema: {
+            title: z.string().describe("Task title."),
+            status: z
+                .string()
+                .optional()
+                .describe("Status select value, e.g. Todo / In Progress / Done."),
+            due: z
+                .string()
+                .optional()
+                .describe("Due date as ISO 8601 (YYYY-MM-DD)."),
+        },
+    }, ({ title, status, due }) => {
+        const propLines = [`- title: ${JSON.stringify(title)}`];
+        if (status)
+            propLines.push(`- status: ${JSON.stringify(status)}`);
+        if (due)
+            propLines.push(`- due: ${JSON.stringify(due)}`);
+        return userMessage([
+            `Create a new Notion task page with these fields:`,
+            ...propLines,
+            ``,
+            `Steps:`,
+            `1. If you don't already know which database holds tasks, call notion_execute with operation "search_pages" (or query_database against a known tasks DB) to locate it.`,
+            `2. Call notion_execute with operation "create_page" and a payload that sets parent.database_id (or data_source_id) plus a properties object containing Title=${JSON.stringify(title)}${status ? `, Status=${JSON.stringify(status)}` : ""}${due ? `, Due=${JSON.stringify(due)}` : ""}.`,
+            `3. Return the new page url to the user.`,
+        ].join("\n"));
+    });
+    server.registerPrompt("weekly_review", {
+        title: "Weekly review of completed work",
+        description: "Summarize tasks marked Done in the last 7 days from a Notion database.",
+        argsSchema: {},
+    }, () => userMessage([
+        `Generate a weekly review of completed Notion tasks.`,
+        ``,
+        `Steps:`,
+        `1. Identify the tasks database (ask the user if you don't know its id).`,
+        `2. Call notion_execute with operation "query_database" using a filter for Status=Done AND Last edited time (or Created time) on_or_after the date 7 days ago. Sort by last_edited_time descending.`,
+        `3. Summarize the results grouped by theme or project, with bullet points and links to each page.`,
+    ].join("\n")));
+    server.registerPrompt("find_pages", {
+        title: "Find Notion pages by query",
+        description: "Search Notion and show the top 5 matching pages.",
+        argsSchema: {
+            query: z.string().describe("Text to search for across page titles."),
+        },
+    }, ({ query }) => userMessage([
+        `Find Notion pages matching ${JSON.stringify(query)}.`,
+        ``,
+        `Steps:`,
+        `1. Call notion_execute with operation "search_pages" and payload { "query": ${JSON.stringify(query)} }.`,
+        `2. Take the top 5 results and present them as a numbered list with each page's title and url.`,
+        `3. If there are no results, say so plainly.`,
+    ].join("\n")));
+    server.registerPrompt("daily_log", {
+        title: "Append to daily log",
+        description: "Append a timestamped paragraph to a daily-log page in Notion.",
+        argsSchema: {
+            date: z
+                .string()
+                .optional()
+                .describe("Date for the entry as ISO 8601 (defaults to today)."),
+            content: z
+                .string()
+                .optional()
+                .describe("Text to append; prompt the user if omitted."),
+        },
+    }, ({ date, content }) => {
+        const pageId = process.env.NOTION_DAILY_LOG_PAGE_ID;
+        const pageLine = pageId
+            ? `The daily-log page id is ${pageId} (from NOTION_DAILY_LOG_PAGE_ID).`
+            : `NOTION_DAILY_LOG_PAGE_ID is not set — ask the user for the daily-log page id or search for it.`;
+        const dateLine = date ? `Use the date ${date}.` : `Use today's date.`;
+        const contentLine = content
+            ? `Append this content: ${JSON.stringify(content)}.`
+            : `Ask the user what to log if the content is not yet known.`;
+        return userMessage([
+            `Append a timestamped paragraph to the user's daily-log page.`,
+            ``,
+            pageLine,
+            dateLine,
+            contentLine,
+            ``,
+            `Steps:`,
+            `1. Compose a paragraph block prefixed with the timestamp (date + current time).`,
+            `2. Call notion_execute with operation "append_blocks" and a payload of { "block_id": "<daily-log page id>", "children": [{ "type": "paragraph", "paragraph": { "rich_text": [{ "type": "text", "text": { "content": "<timestamp> — <content>" } }] } }] }.`,
+            `3. Report back the appended block's id.`,
+        ].join("\n"));
+    });
+}

package/build/schema/blocks.js

@@ -59,6 +59,23 @@ export const HEADING3_BLOCK_REQUEST_SCHEMA = BASE_BLOCK_REQUEST_SCHEMA.extend({
             .describe("Whether heading can be toggled"),
     }).describe("Heading 3 block content"),
 });
+export const HEADING4_BLOCK_REQUEST_SCHEMA = BASE_BLOCK_REQUEST_SCHEMA.extend({
+    type: z.literal("heading_4").describe("Heading 4 block type"),
+    heading_4: TEXT_BLOCK_BASE_REQUEST_SCHEMA.extend({
+        is_toggleable: z
+            .boolean()
+            .optional()
+            .describe("Whether heading can be toggled"),
+    }).describe("Heading 4 block content"),
+});
+export const TAB_BLOCK_REQUEST_SCHEMA = BASE_BLOCK_REQUEST_SCHEMA.extend({
+    type: z.literal("tab").describe("Tab block type"),
+    tab: z
+        .object({
+        icon: ICON_SCHEMA.optional(),
+    })
+        .describe("Tab block content"),
+});
 export const QUOTE_BLOCK_REQUEST_SCHEMA = BASE_BLOCK_REQUEST_SCHEMA.extend({
     type: z.literal("quote").describe("Quote block type"),
     quote: TEXT_BLOCK_BASE_REQUEST_SCHEMA.describe("Quote block content"),
@@ -119,6 +136,7 @@ export const TEXT_BLOCK_REQUEST_SCHEMA = z.preprocess(preprocessJson, z
     HEADING1_BLOCK_REQUEST_SCHEMA,
     HEADING2_BLOCK_REQUEST_SCHEMA,
     HEADING3_BLOCK_REQUEST_SCHEMA,
+    HEADING4_BLOCK_REQUEST_SCHEMA,
     QUOTE_BLOCK_REQUEST_SCHEMA,
     CALLOUT_BLOCK_REQUEST_SCHEMA,
     TOGGLE_BLOCK_REQUEST_SCHEMA,
@@ -128,82 +146,6 @@ export const TEXT_BLOCK_REQUEST_SCHEMA = z.preprocess(preprocessJson, z
     CODE_BLOCK_REQUEST_SCHEMA,
     DIVIDER_BLOCK_REQUEST_SCHEMA,
     IMAGE_BLOCK_REQUEST_SCHEMA,
+    TAB_BLOCK_REQUEST_SCHEMA,
 ])
     .describe("Union of all possible text block request types"));
-export const APPEND_BLOCK_CHILDREN_SCHEMA = {
-    blockId: z.string().describe("The ID of the block to append children to"),
-    children: z
-        .array(TEXT_BLOCK_REQUEST_SCHEMA)
-        .describe("Array of blocks to append as children"),
-};
-export const RETRIEVE_BLOCK_SCHEMA = {
-    blockId: z.string().describe("The ID of the block to retrieve"),
-};
-export const RETRIEVE_BLOCK_CHILDREN_SCHEMA = {
-    blockId: z.string().describe("The ID of the block to retrieve children for"),
-    start_cursor: z.string().optional().describe("Cursor for pagination"),
-    page_size: z
-        .number()
-        .min(1)
-        .max(100)
-        .optional()
-        .describe("Number of results to return (1-100)"),
-};
-export const UPDATE_BLOCK_SCHEMA = {
-    blockId: z.string().describe("The ID of the block to update"),
-    data: TEXT_BLOCK_REQUEST_SCHEMA.describe("The block data to update"),
-};
-export const DELETE_BLOCK_SCHEMA = {
-    blockId: z.string().describe("The ID of the block to delete/archive"),
-};
-// Batch operation schemas for multiple blocks
-export const BATCH_APPEND_BLOCK_CHILDREN_SCHEMA = {
-    operations: z
-        .array(z.object({
-        blockId: z
-            .string()
-            .describe("The ID of the block to append children to"),
-        children: z
-            .array(TEXT_BLOCK_REQUEST_SCHEMA)
-            .describe("Array of blocks to append as children"),
-    }))
-        .describe("Array of append operations to perform in a single batch"),
-};
-export const BATCH_UPDATE_BLOCKS_SCHEMA = {
-    operations: z
-        .array(z.object({
-        blockId: z.string().describe("The ID of the block to update"),
-        data: TEXT_BLOCK_REQUEST_SCHEMA.describe("The block data to update"),
-    }))
-        .describe("Array of update operations to perform in a single batch"),
-};
-export const BATCH_DELETE_BLOCKS_SCHEMA = {
-    blockIds: z
-        .array(z.string().describe("The ID of a block to delete/archive"))
-        .describe("Array of block IDs to delete in a single batch"),
-};
-// Schema for multi-operation batches (mixed operations)
-export const BATCH_MIXED_OPERATIONS_SCHEMA = {
-    operations: z
-        .array(z.discriminatedUnion("operation", [
-        z.object({
-            operation: z.literal("append"),
-            blockId: z
-                .string()
-                .describe("The ID of the block to append children to"),
-            children: z
-                .array(TEXT_BLOCK_REQUEST_SCHEMA)
-                .describe("Array of blocks to append as children"),
-        }),
-        z.object({
-            operation: z.literal("update"),
-            blockId: z.string().describe("The ID of the block to update"),
-            data: TEXT_BLOCK_REQUEST_SCHEMA.describe("The block data to update"),
-        }),
-        z.object({
-            operation: z.literal("delete"),
-            blockId: z.string().describe("The ID of the block to delete/archive"),
-        }),
-    ]))
-        .describe("Array of mixed operations to perform in a single batch"),
-};

package/build/schema/database.js

@@ -1,11 +1,6 @@
 import { z } from "zod";
-import { ICON_SCHEMA } from "./icon.js";
-import { FILE_SCHEMA } from "./file.js";
-import { PARENT_SCHEMA } from "./page.js";
-import { RICH_TEXT_ITEM_REQUEST_SCHEMA, TEXT_CONTENT_REQUEST_SCHEMA, TEXT_RICH_TEXT_ITEM_REQUEST_SCHEMA, } from "./rich-text.js";
 import { preprocessJson } from "./preprocess.js";
 import { NUMBER_FORMAT } from "./number.js";
-import { getRootPageId } from "../services/notion.js";
 export const EMPTY_OBJECT_SCHEMA = z.record(z.string(), z.never()).default({});
 export const SELECT_COLOR_SCHEMA = z.enum([
     "default",
@@ -19,14 +14,6 @@ export const SELECT_COLOR_SCHEMA = z.enum([
     "pink",
     "red",
 ]);
-// Title property for database creation
-export const TITLE_PROPERTY_SCHEMA = z.object({
-    title: z
-        .array(z.object({
-        text: TEXT_CONTENT_REQUEST_SCHEMA.describe("Text content for title segment"),
-    }))
-        .describe("Array of text segments that make up the title"),
-});
 // Database property schemas
 // 1. Title property
 export const TITLE_DB_PROPERTY_SCHEMA = z.object({
@@ -242,6 +229,30 @@ export const STATUS_DB_PROPERTY_SCHEMA = z.object({
         .describe("Status property configuration"),
     description: z.string().optional().describe("Property description"),
 });
+export const BUTTON_DB_PROPERTY_SCHEMA = z.object({
+    type: z.literal("button"),
+    button: EMPTY_OBJECT_SCHEMA,
+    description: z.string().optional(),
+});
+export const UNIQUE_ID_DB_PROPERTY_SCHEMA = z.object({
+    type: z.literal("unique_id"),
+    unique_id: z
+        .object({
+        prefix: z
+            .string()
+            .regex(/^[A-Za-z][A-Za-z0-9-]{1,9}$/, "prefix must start with a letter, then 1–9 more letters/digits/hyphens (total length 2–10)")
+            .nullable()
+            .optional()
+            .describe("Prefix shown before the auto-incrementing number. 2–10 chars total, must start with a letter, alphanumeric + hyphen only. Single-letter prefixes are rejected by Notion."),
+    })
+        .describe("Unique ID property configuration"),
+    description: z.string().optional(),
+});
+export const VERIFICATION_DB_PROPERTY_SCHEMA = z.object({
+    type: z.literal("verification"),
+    verification: EMPTY_OBJECT_SCHEMA,
+    description: z.string().optional(),
+});
 // Combined database property schema
 export const DATABASE_PROPERTY_SCHEMA = z.preprocess(preprocessJson, z
     .discriminatedUnion("type", [
@@ -264,78 +275,8 @@ export const DATABASE_PROPERTY_SCHEMA = z.preprocess(preprocessJson, z
     CREATED_BY_DB_PROPERTY_SCHEMA,
     LAST_EDITED_TIME_DB_PROPERTY_SCHEMA,
     LAST_EDITED_BY_DB_PROPERTY_SCHEMA,
+    BUTTON_DB_PROPERTY_SCHEMA,
+    UNIQUE_ID_DB_PROPERTY_SCHEMA,
+    VERIFICATION_DB_PROPERTY_SCHEMA,
 ])
     .describe("Union of all possible database property types"));
-// Create database schema
-export const CREATE_DATABASE_SCHEMA = {
-    parent: PARENT_SCHEMA.optional()
-        .default({
-        type: "page_id",
-        page_id: getRootPageId(),
-    })
-        .describe("Optional parent - if not provided, will use NOTION_PAGE_ID as parent page"),
-    title: z.array(TEXT_RICH_TEXT_ITEM_REQUEST_SCHEMA).describe("Database title"),
-    description: z
-        .array(TEXT_RICH_TEXT_ITEM_REQUEST_SCHEMA)
-        .optional()
-        .describe("Database description"),
-    properties: z
-        .record(z.string().describe("Property name"), DATABASE_PROPERTY_SCHEMA.describe("Property schema"))
-        .describe("Database properties"),
-    is_inline: z
-        .boolean()
-        .optional()
-        .default(false)
-        .describe("Whether database is inline"),
-    icon: z.preprocess(preprocessJson, ICON_SCHEMA.nullable().optional().describe("Optional icon for the database")),
-    cover: z.preprocess(preprocessJson, FILE_SCHEMA.nullable()
-        .optional()
-        .describe("Optional cover image for the database")),
-};
-// Query database schema
-export const QUERY_DATABASE_SCHEMA = {
-    database_id: z.string().describe("The ID of the database to query"),
-    filter: z
-        .preprocess(preprocessJson, z.any())
-        .optional()
-        .describe("Filter criteria for the query"),
-    sorts: z
-        .array(z.object({
-        property: z.string().optional().describe("Property to sort by"),
-        timestamp: z
-            .enum(["created_time", "last_edited_time"])
-            .describe("Timestamp to sort by"),
-        direction: z
-            .enum(["ascending", "descending"])
-            .describe("Sort direction"),
-    }))
-        .optional()
-        .describe("Sort criteria for the query"),
-    start_cursor: z.string().optional().describe("Cursor for pagination"),
-    page_size: z
-        .number()
-        .min(1)
-        .max(100)
-        .optional()
-        .describe("Number of results to return (1-100)"),
-};
-// Update database schema
-export const UPDATE_DATABASE_SCHEMA = {
-    database_id: z.string().describe("The ID of the database to update"),
-    title: z
-        .array(RICH_TEXT_ITEM_REQUEST_SCHEMA)
-        .optional()
-        .describe("Updated database title"),
-    description: z
-        .array(RICH_TEXT_ITEM_REQUEST_SCHEMA)
-        .optional()
-        .describe("Updated database description"),
-    properties: z
-        .record(z.string().describe("Property name"), DATABASE_PROPERTY_SCHEMA.describe("Property schema"))
-        .describe("Properties of the page"),
-    is_inline: z.boolean().optional().describe("Whether database is inline"),
-    icon: z.preprocess(preprocessJson, ICON_SCHEMA.nullable().optional().describe("Updated icon for the database")),
-    cover: z.preprocess(preprocessJson, FILE_SCHEMA.nullable()
-        .optional()
-        .describe("Updated cover image for the database")),
-};

package/build/schema/emit.js

@@ -0,0 +1,68 @@
+import { z } from "zod";
+const SHARED_REFS = {};
+export function registerSharedRef(name, schema) {
+    SHARED_REFS[name] = schema;
+}
+export function emitJsonSchema(schema) {
+    const raw = z.toJSONSchema(schema, {
+        target: "draft-7",
+        unrepresentable: "any",
+    });
+    return hoistSharedRefs(raw);
+}
+function hoistSharedRefs(root) {
+    const sharedSchemas = {};
+    for (const [name, zodSchema] of Object.entries(SHARED_REFS)) {
+        const raw = z.toJSONSchema(zodSchema, {
+            target: "draft-7",
+            unrepresentable: "any",
+        });
+        // Root-level emission adds `$schema`, but nested inline usages don't carry it.
+        // Strip it so the equality key matches inline sites.
+        const { $schema: _drop, ...rest } = raw;
+        void _drop;
+        sharedSchemas[name] = rest;
+    }
+    const refByJson = new Map();
+    for (const [name, json] of Object.entries(sharedSchemas)) {
+        refByJson.set(stableStringify(json), name);
+    }
+    let usedNames = new Set();
+    function walk(node) {
+        if (Array.isArray(node))
+            return node.map(walk);
+        if (node === null || typeof node !== "object")
+            return node;
+        const obj = node;
+        const key = stableStringify(obj);
+        const match = refByJson.get(key);
+        if (match) {
+            usedNames.add(match);
+            return { $ref: `#/$defs/${match}` };
+        }
+        const out = {};
+        for (const [k, v] of Object.entries(obj))
+            out[k] = walk(v);
+        return out;
+    }
+    const walked = walk(root);
+    if (usedNames.size === 0)
+        return walked;
+    const defs = walked.$defs ?? {};
+    for (const name of usedNames) {
+        if (!(name in defs))
+            defs[name] = walk(sharedSchemas[name]);
+    }
+    return { ...walked, $defs: defs };
+}
+function stableStringify(value) {
+    if (value === null || typeof value !== "object")
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return "[" + value.map(stableStringify).join(",") + "]";
+    const obj = value;
+    const keys = Object.keys(obj).sort();
+    return ("{" +
+        keys.map((k) => JSON.stringify(k) + ":" + stableStringify(obj[k])).join(",") +
+        "}");
+}

package/build/schema/file.js

@@ -3,7 +3,7 @@ export const FILE_SCHEMA = z
     .object({
     external: z
         .object({
-        url: z.string().url().describe("URL of the external file"),
+        url: z.url({ protocol: /^https?$/ }).describe("URL of the external file"),
     })
         .describe("External file source"),
     type: z.literal("external").describe("Type of file source"),