Add support for empty gist files

Author: lostintangent

CHANGELOG.md

@@ -2,6 +2,7 @@
 
 - Added the `refresh_gists` tool
 - The list of gist resources are now sorted by modified date (descending)
+- Empty gist files can now be created (if desired)
 
 ## 📆 v0.4.4 (06/12/2025)
 

src/tools/files.ts

@@ -1,5 +1,6 @@
 import { ErrorCode, McpError } from "@modelcontextprotocol/sdk/types.js";
 import { Gist, RequestContext, ToolModule } from "../types.js";
+import { gistContent } from "../utils.js";
 
 type FileAssertions = {
     exists?: string;
@@ -154,7 +155,9 @@ export default {
 
             await assertGistFile(context, id, { exists: filename });
 
-            await patchGistFile(context, id, filename, { content });
+            await patchGistFile(context, id, filename, {
+                content: gistContent(content),
+            });
 
             return "File updated successfully";
         },
@@ -168,7 +171,9 @@ export default {
 
             await assertGistFile(context, id, { notExists: filename });
 
-            await patchGistFile(context, id, filename, { content });
+            await patchGistFile(context, id, filename, {
+                content: gistContent(content),
+            });
 
             return "File added successfully";
         },

src/tools/gist.ts

@@ -1,6 +1,7 @@
 import { ErrorCode, McpError } from "@modelcontextprotocol/sdk/types.js";
 import { Gist, ToolModule } from "../types.js";
 import {
+    gistContent,
     isArchivedGist,
     isDailyNoteGist,
     isPromptGist,
@@ -138,7 +139,7 @@ export default {
             const {
                 description = "",
                 filename = "README.md",
-                content,
+                content = "",
                 public: isPublic = false,
             } = args;
 
@@ -154,7 +155,7 @@ export default {
                 public: isPublic,
                 files: {
                     [filename as string]: {
-                        content,
+                        content: gistContent(content as string),
                     },
                 },
             });

src/utils.ts

@@ -36,4 +36,11 @@ export function isPromptGist(gist: Gist): boolean {
 
 export function isContentLoaded(gist: Gist): boolean {
     return Object.values(gist.files).every((file) => file.content !== undefined);
+}
+
+// Gist's aren't allowed to be empty, so we're using an
+// "invisible plus" as content when the content is empty.
+const EMPTY_FILE_CONTENT = "\u{2064}";
+export function gistContent(content: string): string {
+    return content || EMPTY_FILE_CONTENT;
 }