notion-mcp-server 2.11.0 → 2.12.0

package/build/operations/files.js

@@ -1,4 +1,7 @@
 import { z } from "zod";
+import { readFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { basename } from "node:path";
 import { getClient } from "../services/notion.js";
 import { register } from "./registry.js";
 import { tryHandler } from "../utils/handler.js";
@@ -16,7 +19,23 @@ const SourceSchema = z.discriminatedUnion("type", [
         type: z.literal("url"),
         url: z.url().describe("Public URL to fetch the file bytes from."),
     }),
+    z.object({
+        type: z.literal("path"),
+        path: z
+            .string()
+            .describe("Local filesystem path (absolute, or ~-relative). The server reads the file directly — bytes never pass through the tool call, so this is the fastest, cheapest source for files on the same machine as the server."),
+    }),
 ]);
+// Expand a leading ~ or ~/ to the current user's home directory. Node's fs
+// does not do this itself, and ~-relative paths are the common shape a caller
+// hands to a local stdio server.
+function expandHome(p) {
+    if (p === "~")
+        return homedir();
+    if (p.startsWith("~/"))
+        return homedir() + p.slice(1);
+    return p;
+}
 // Returns Uint8Array<ArrayBuffer> — the DOM Blob constructor's BlobPart type
 // rejects Uint8Array<ArrayBufferLike> under newer @types/node (it widens to
 // include SharedArrayBuffer). Allocating fresh guarantees the concrete type.
@@ -27,6 +46,12 @@ async function resolveBytes(source) {
         out.set(buf);
         return out;
     }
+    if (source.type === "path") {
+        const buf = await readFile(expandHome(source.path));
+        const out = new Uint8Array(buf.byteLength);
+        out.set(buf);
+        return out;
+    }
     const res = await fetch(source.url);
     if (!res.ok) {
         throw new Error(`Failed to fetch ${source.url}: ${res.status} ${res.statusText}`);
@@ -97,8 +122,17 @@ const EXTENSION_TO_MIME = {
     // Documents
     csv: "text/csv",
     json: "application/json",
+    md: "text/markdown",
+    markdown: "text/markdown",
     pdf: "application/pdf",
     txt: "text/plain",
+    // Microsoft Office
+    doc: "application/msword",
+    docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    ppt: "application/vnd.ms-powerpoint",
+    pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+    xls: "application/vnd.ms-excel",
+    xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
 };
 function inferContentType(filename) {
     const dot = filename.lastIndexOf(".");
@@ -115,7 +149,10 @@ const UploadFileParams = z.object({
         .enum(["single", "multi"])
         .optional()
         .describe("'single' (default) = one create+send call. 'multi' = chunk into 5MB parts then complete."),
-    filename: z.string(),
+    filename: z
+        .string()
+        .optional()
+        .describe("Required for base64 and url sources. Optional for a path source — defaults to the file's basename."),
     content_type: z.string().optional(),
     source: SourceSchema,
 });
@@ -123,7 +160,7 @@ register({
     name: "upload_file",
     access: "write",
     domain: "files",
-    description: "Upload a file via Notion's file_uploads API. Handles single-part (one create + one send) and multi-part (create + N sends + complete) transparently.\n\nSource shapes:\n  • Base64 bytes: `source: { type: \"base64\", data: \"<b64 string>\" }`\n  • Public URL:   `source: { type: \"url\", url: \"https://example.com/file.pdf\" }` (the server fetches it server-side).\n\n`mode` defaults to \"single\"; only pass \"multi\" for files larger than ~5MB.",
+    description: "Upload a file via Notion's file_uploads API. Handles single-part (one create + one send) and multi-part (create + N sends + complete) transparently.\n\nSource shapes:\n  • Local path:   `source: { type: \"path\", path: \"/abs/or/~/file.pdf\" }` (server reads the file directly — preferred for local files; filename is derived from the path if omitted).\n  • Base64 bytes: `source: { type: \"base64\", data: \"<b64 string>\" }`\n  • Public URL:   `source: { type: \"url\", url: \"https://example.com/file.pdf\" }` (the server fetches it server-side).\n\n`mode` defaults to \"single\"; only pass \"multi\" for files larger than ~5MB.",
     batchable: false,
     schema: UploadFileParams,
     example: {
@@ -133,19 +170,34 @@ register({
     },
     handler: tryHandler(async ({ mode, filename, content_type, source }) => {
         const effectiveMode = mode ?? "single";
+        // A path source carries its own name; fall back to the basename when the
+        // caller doesn't pass filename explicitly. base64/url have no name to
+        // derive, so filename stays required there.
+        const effectiveFilename = filename ??
+            (source.type === "path" ? basename(expandHome(source.path)) : undefined);
+        if (!effectiveFilename) {
+            return {
+                ok: false,
+                error: {
+                    code: "validation_error",
+                    message: "filename is required for base64 and url sources (there is no name to derive).",
+                    fix: 'Pass `filename` (e.g. "report.pdf"), or use a path source to derive it from the path.',
+                },
+            };
+        }
         const notion = await getClient();
         const bytes = await resolveBytes(source);
         // Notion rejects send() when the Blob's MIME doesn't match the
         // content_type stored at create(), and rejects application/octet-stream
         // outright. Resolve a single MIME for both sides: caller's content_type
         // wins, else infer from the filename extension.
-        const effectiveType = content_type ?? inferContentType(filename);
+        const effectiveType = content_type ?? inferContentType(effectiveFilename);
         if (!effectiveType) {
             return {
                 ok: false,
                 error: {
                     code: "validation_error",
-                    message: `Could not infer content_type from filename "${filename}". Notion's File Upload API rejects application/octet-stream and only accepts a fixed allowlist of MIME types.`,
+                    message: `Could not infer content_type from filename "${effectiveFilename}". Notion's File Upload API rejects application/octet-stream and only accepts a fixed allowlist of MIME types.`,
                     fix: "Pass `content_type` explicitly (e.g. \"application/pdf\", \"image/png\", \"text/plain\"). See https://developers.notion.com/docs/working-with-files-and-media for the full list.",
                 },
             };
@@ -153,13 +205,16 @@ register({
         if (effectiveMode === "single") {
             const createBody = {
                 mode: "single_part",
-                filename,
+                filename: effectiveFilename,
                 content_type: effectiveType,
             };
             const created = await notion.fileUploads.create(createBody);
             const sendBody = {
                 file_upload_id: created.id,
-                file: { filename, data: new Blob([bytes], { type: effectiveType }) },
+                file: {
+                    filename: effectiveFilename,
+                    data: new Blob([bytes], { type: effectiveType }),
+                },
             };
             const sent = await notion.fileUploads.send(sendBody);
             return { ok: true, data: slimFileUpload(sent) };
@@ -167,7 +222,7 @@ register({
         const parts = splitIntoParts(bytes);
         const createBody = {
             mode: "multi_part",
-            filename,
+            filename: effectiveFilename,
             content_type: effectiveType,
             number_of_parts: parts.length,
         };
@@ -176,7 +231,10 @@ register({
             const partNumber = index + 1;
             const sendBody = {
                 file_upload_id: created.id,
-                file: { filename, data: new Blob([part], { type: effectiveType }) },
+                file: {
+                    filename: effectiveFilename,
+                    data: new Blob([part], { type: effectiveType }),
+                },
                 part_number: String(partNumber),
             };
             try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "notion-mcp-server",
-  "version": "2.11.0",
+  "version": "2.12.0",
   "mcpName": "io.github.awkoy/notion-mcp-server",
   "type": "module",
   "bin": {