notion-mcp-server 0.0.1

package/build/schema/color.js

@@ -0,0 +1,22 @@
+import { z } from "zod";
+export const COLOR_SCHEMA = z.enum([
+    "default",
+    "gray",
+    "brown",
+    "orange",
+    "yellow",
+    "green",
+    "blue",
+    "purple",
+    "pink",
+    "red",
+    "gray_background",
+    "brown_background",
+    "orange_background",
+    "yellow_background",
+    "green_background",
+    "blue_background",
+    "purple_background",
+    "pink_background",
+    "red_background",
+]);

package/build/schema/file.js

@@ -0,0 +1,11 @@
+import { z } from "zod";
+export const FILE_SCHEMA = z
+    .object({
+    external: z
+        .object({
+        url: z.string().url().describe("URL of the external file"),
+    })
+        .describe("External file source"),
+    type: z.literal("external").describe("Type of file source"),
+})
+    .describe("File schema");

package/build/schema/icon.js

@@ -0,0 +1,10 @@
+import { z } from "zod";
+export const ICON_SCHEMA = z.object({
+    emoji: z
+        .string()
+        .refine((value) => /(\p{Emoji}\uFE0F|\p{Emoji_Presentation})/gu.test(value), {
+        message: "Invalid emoji",
+    })
+        .transform((value) => value),
+    type: z.literal("emoji"),
+});

package/build/schema/lang.js

@@ -0,0 +1,77 @@
+import { z } from "zod";
+export const LANGUAGE_SCHEMA = z
+    .enum([
+    "abap",
+    "arduino",
+    "bash",
+    "basic",
+    "c",
+    "clojure",
+    "coffeescript",
+    "c++",
+    "c#",
+    "css",
+    "dart",
+    "diff",
+    "docker",
+    "elixir",
+    "elm",
+    "erlang",
+    "flow",
+    "fortran",
+    "f#",
+    "gherkin",
+    "glsl",
+    "go",
+    "graphql",
+    "groovy",
+    "haskell",
+    "html",
+    "java",
+    "javascript",
+    "json",
+    "julia",
+    "kotlin",
+    "latex",
+    "less",
+    "lisp",
+    "livescript",
+    "lua",
+    "makefile",
+    "markdown",
+    "markup",
+    "matlab",
+    "mermaid",
+    "nix",
+    "objective-c",
+    "ocaml",
+    "pascal",
+    "perl",
+    "php",
+    "plain text",
+    "powershell",
+    "prolog",
+    "protobuf",
+    "python",
+    "r",
+    "reason",
+    "ruby",
+    "rust",
+    "sass",
+    "scala",
+    "scheme",
+    "scss",
+    "shell",
+    "sql",
+    "swift",
+    "typescript",
+    "vb.net",
+    "verilog",
+    "vhdl",
+    "visual basic",
+    "webassembly",
+    "xml",
+    "yaml",
+    "java/c/c++/c#",
+])
+    .describe("Programming language for code blocks");

package/build/schema/mention.js

@@ -0,0 +1,102 @@
+import { z } from "zod";
+export const TEMPLATE_MENTION_USER_REQUEST_SCHEMA = z
+    .object({
+    type: z
+        .literal("template_mention")
+        .describe("Specifies this is a template mention type"),
+    template_mention: z
+        .object({
+        type: z
+            .literal("template_mention_user")
+            .describe("Specifies this is a template mention user type"),
+        template_mention_user: z
+            .literal("me")
+            .describe("Template mention user value"),
+    })
+        .describe("Contains the template mention user information"),
+})
+    .describe("Schema for a template mention user block request");
+export const TEMPLATE_MENTION_DATE_REQUEST_SCHEMA = z
+    .object({
+    type: z
+        .literal("template_mention")
+        .describe("Specifies this is a template mention type"),
+    template_mention: z
+        .object({
+        type: z
+            .literal("template_mention_date")
+            .describe("Specifies this is a template mention date type"),
+        template_mention_date: z
+            .literal("today")
+            .describe("Template mention date value"),
+    })
+        .describe("Contains the template mention date information"),
+})
+    .describe("Schema for a template mention date block request");
+export const USER_MENTION_REQUEST_SCHEMA = z
+    .object({
+    type: z.literal("user").describe("Specifies this is a user mention type"),
+    user: z
+        .object({
+        id: z
+            .string()
+            .describe("The unique ID that identifies this specific user"),
+        object: z
+            .literal("user")
+            .optional()
+            .describe("Identifies this object as a user type"),
+    })
+        .describe("Contains the user reference information"),
+})
+    .describe("Schema for a user mention block request");
+export const PAGE_MENTION_REQUEST_SCHEMA = z
+    .object({
+    type: z.literal("page").describe("Specifies this is a page mention type"),
+    page: z
+        .object({
+        id: z
+            .string()
+            .describe("The unique ID that identifies this specific page"),
+    })
+        .describe("Contains the page reference information"),
+})
+    .describe("Schema for a page mention block request");
+export const DATABASE_MENTION_REQUEST_SCHEMA = z
+    .object({
+    type: z
+        .literal("database")
+        .describe("Specifies this is a database mention type"),
+    database: z
+        .object({
+        id: z
+            .string()
+            .describe("The unique ID that identifies this specific database"),
+    })
+        .describe("Contains the database reference information"),
+})
+    .describe("Schema for a database mention block request");
+export const DATE_MENTION_REQUEST_SCHEMA = z
+    .object({
+    type: z.literal("date").describe("Specifies this is a date mention type"),
+    date: z
+        .object({
+        start: z.string().describe("The start date in YYYY-MM-DD format"),
+        end: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("The optional end date in YYYY-MM-DD format"),
+    })
+        .describe("Contains the date information"),
+})
+    .describe("Schema for a date mention block request");
+export const MENTION_REQUEST_SCHEMA = z.preprocess((val) => (typeof val === "string" ? JSON.parse(val) : val), z
+    .union([
+    DATE_MENTION_REQUEST_SCHEMA,
+    USER_MENTION_REQUEST_SCHEMA,
+    PAGE_MENTION_REQUEST_SCHEMA,
+    DATABASE_MENTION_REQUEST_SCHEMA,
+    TEMPLATE_MENTION_USER_REQUEST_SCHEMA,
+    TEMPLATE_MENTION_DATE_REQUEST_SCHEMA,
+])
+    .describe("Union of all possible mention request types"));

package/build/schema/notion.js

@@ -0,0 +1,57 @@
+// import { z } from "zod";
+// import { richTextSchema } from "./richText.js";
+export {};
+// export const parentSchema = z
+//   .object({
+//     type: z.enum(["page_id", "database_id"]),
+//     page_id: z.string().optional(),
+//     database_id: z.string().optional(),
+//   })
+//   .refine(
+//     (data) => {
+//       if (data.type === "page_id" && !data.page_id) return false;
+//       if (data.type === "database_id" && !data.database_id) return false;
+//       return true;
+//     },
+//     {
+//       message:
+//         "page_id must be provided when type is page_id, database_id must be provided when type is database_id",
+//     }
+//   );
+// export const pageParentPropertiesSchema = z.object({
+//   title: z.object({
+//     title: richTextSchema,
+//   }),
+// });
+// export const databaseParentPropertiesSchema = z.record(
+//   z.string(),
+//   z.union([
+//     z.object({ title: richTextSchema }),
+//     z.object({ rich_text: richTextSchema }),
+//     z.object({ number: z.number().optional().nullable() }),
+//     z.object({ select: z.object({ name: z.string() }).optional().nullable() }),
+//     z.object({
+//       multi_select: z.array(z.object({ name: z.string() })).optional(),
+//     }),
+//     z.object({
+//       date: z
+//         .object({
+//           start: z.string(),
+//           end: z.string().optional(),
+//           time_zone: z.string().optional(),
+//         })
+//         .optional()
+//         .nullable(),
+//     }),
+//     z.object({ checkbox: z.boolean().optional() }),
+//     z.object({ url: z.string().url().optional().nullable() }),
+//     z.object({ email: z.string().email().optional().nullable() }),
+//     z.object({ phone_number: z.string().optional().nullable() }),
+//   ])
+// );
+// export const blockSchema = z
+//   .object({
+//     object: z.literal("block"),
+//     type: z.string(),
+//   })
+//   .and(z.record(z.string(), z.any()));

package/build/schema/page.js

@@ -0,0 +1,68 @@
+import { z } from "zod";
+import { getRootPageId } from "../services/notion.js";
+import { ICON_SCHEMA } from "./icon.js";
+import { TEXT_BLOCK_REQUEST_SCHEMA } from "./blocks.js";
+import { preprocessJson } from "./preprocess.js";
+import { TEXT_CONTENT_REQUEST_SCHEMA } from "./rich-text.js";
+import { FILE_SCHEMA } from "./file.js";
+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"),
+});
+export const PARENT_SCHEMA = z.preprocess((val) => (typeof val === "string" ? JSON.parse(val) : val), z.union([
+    z.object({
+        type: z.literal("page_id").describe("Parent type for page"),
+        page_id: z.string().describe("ID of the parent page"),
+    }),
+    z.object({
+        type: z.literal("database_id").describe("Parent type for database"),
+        database_id: z.string().describe("ID of the parent database"),
+    }),
+]));
+export const CREATE_PAGE_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"),
+    properties: z
+        .object({
+        title: TITLE_PROPERTY_SCHEMA.describe("The title of the page"),
+    })
+        .describe("Properties of the page"),
+    children: z
+        .array(TEXT_BLOCK_REQUEST_SCHEMA)
+        .optional()
+        .describe("Optional array of paragraph blocks to add as page content"),
+    icon: z.preprocess(preprocessJson, ICON_SCHEMA.nullable().optional().describe("Optional icon for the page")),
+    cover: z.preprocess(preprocessJson, FILE_SCHEMA.nullable()
+        .optional()
+        .describe("Optional cover image for the page")),
+};
+export const ARCHIVE_PAGE_SCHEMA = {
+    pageId: z.string().describe("The ID of the page to archive"),
+};
+export const RESTORE_PAGE_SCHEMA = {
+    pageId: z.string().describe("The ID of the page to restore"),
+};
+export const SEARCH_PAGES_SCHEMA = {
+    query: z.string().optional().describe("Search query for filtering by title"),
+    sort: z
+        .object({
+        direction: z.enum(["ascending", "descending"]),
+        timestamp: z.literal("last_edited_time"),
+    })
+        .optional()
+        .describe("Sort order for results"),
+    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)"),
+};

package/build/schema/preprocess.js

@@ -0,0 +1 @@
+export const preprocessJson = (val) => typeof val === "string" ? JSON.parse(val) : val;

package/build/schema/rich-text.js

@@ -0,0 +1,71 @@
+import { z } from "zod";
+import { ANNOTATIONS_SCHEMA } from "./annotations.js";
+import { MENTION_REQUEST_SCHEMA } from "./mention.js";
+export const RICH_TEXT_BASE_SCHEMA = z.object({
+    plain_text: z.string().describe("Plain text content without formatting"),
+    href: z.string().nullable().describe("URL for the link"),
+    annotations: ANNOTATIONS_SCHEMA.describe("Text formatting annotations"),
+});
+export const RICH_TEXT_BASE_REQUEST_SCHEMA = z.object({
+    annotations: ANNOTATIONS_SCHEMA.optional().describe("Text formatting annotations"),
+});
+export const TEXT_CONTENT_REQUEST_SCHEMA = z
+    .object({
+    content: z.string().describe("The actual text content"),
+    link: z
+        .object({
+        url: z.string().url().describe("URL for the link"),
+    })
+        .optional()
+        .nullable()
+        .describe("Optional link associated with the text"),
+})
+    .describe("Text content request object");
+export const EQUATION_CONTENT_SCHEMA = z
+    .object({
+    expression: z.string().describe("LaTeX equation expression"),
+})
+    .describe("Equation content object");
+export const TEXT_RICH_TEXT_ITEM_REQUEST_SCHEMA = z
+    .object({
+    type: z.literal("text").describe("Type of rich text content"),
+    text: TEXT_CONTENT_REQUEST_SCHEMA.describe("Text content"),
+    annotations: ANNOTATIONS_SCHEMA.optional().describe("Text formatting annotations"),
+    plain_text: z
+        .string()
+        .optional()
+        .describe("Plain text content without formatting"),
+    href: z.string().nullable().optional().describe("URL for the link"),
+})
+    .describe("Text rich text item request");
+export const EQUATION_RICH_TEXT_ITEM_REQUEST_SCHEMA = z
+    .object({
+    type: z.literal("equation").describe("Type of equation content"),
+    equation: EQUATION_CONTENT_SCHEMA.describe("Equation content"),
+    annotations: ANNOTATIONS_SCHEMA.optional().describe("Text formatting annotations"),
+    plain_text: z
+        .string()
+        .optional()
+        .describe("Plain text content without formatting"),
+    href: z.string().nullable().optional().describe("URL for the link"),
+})
+    .describe("Equation rich text item request");
+export const MENTION_RICH_TEXT_ITEM_REQUEST_SCHEMA = z
+    .object({
+    type: z.literal("mention").describe("Type of mention content"),
+    mention: MENTION_REQUEST_SCHEMA.describe("Mention content"),
+    annotations: ANNOTATIONS_SCHEMA.optional().describe("Text formatting annotations"),
+    plain_text: z
+        .string()
+        .optional()
+        .describe("Plain text content without formatting"),
+    href: z.string().nullable().optional().describe("URL for the link"),
+})
+    .describe("Mention rich text item request");
+export const RICH_TEXT_ITEM_REQUEST_SCHEMA = z
+    .discriminatedUnion("type", [
+    TEXT_RICH_TEXT_ITEM_REQUEST_SCHEMA,
+    EQUATION_RICH_TEXT_ITEM_REQUEST_SCHEMA,
+    MENTION_RICH_TEXT_ITEM_REQUEST_SCHEMA,
+])
+    .describe("Union of all possible rich text item request types");