reflect-mcp 1.0.9 → 1.0.11

package/dist/tools/index.js

@@ -622,13 +622,13 @@ export function registerTools(server, dbPath) {
     // Tool: Create a new note in Reflect via API
     server.addTool({
         name: "create_note",
-        description: "Create a new note in Reflect. Must add the tasks field if there are any actionable items to add. Pass in the user's timezone to ensure the note is created with the correct date. Check what tags the user has already created, and determine which tag to use for this content, or create a new tag if no tags fit the content.",
+        description: "Create a new note in Reflect. Must add the tasks field if there are any actionable items to add. Pass in the user's timezone to ensure the note is created with the correct date. The backlink_note parameter creates a backlink to another note (e.g., 'Project Planning' creates [[Project Planning]]). For actual tags, use get_tags to see available tags and add them separately if needed.",
         parameters: z.object({
             subject: z.string().describe("The title/subject of the note. Example: 'Meeting Summary - Project Planning'"),
             content: z.string().describe("The markdown content for the note. This is the main body of the note."),
             graph_id: z.string().describe("The unique identifier of the Reflect graph where the note should be created."),
             timezone: z.string().describe("The user's timezone in IANA format. Example: 'America/New_York', 'Europe/London', 'Asia/Tokyo'. Used to determine the correct date for the daily note backlink."),
-            tag: z.string().describe("The tag to add to the note. Example: 'personal'"),
+            backlink_note: z.string().describe("The name of an existing note to backlink to. This creates a backlink [[backlink_note]] in the new note. Example: 'Project Planning' creates [[Project Planning]]. This is NOT a tag - use get_tags for actual tags."),
             tasks: z.array(z.string()).optional().describe("A list of tasks to add to the note. Must add this field if there are any actionable items. Example: ['Review PR', 'Schedule meeting']"),
         }),
         execute: async (args, { session }) => {
@@ -643,11 +643,11 @@ export function registerTools(server, dbPath) {
                 };
             }
             const { accessToken } = session;
-            const { subject, content, graph_id, timezone, tag, tasks } = args;
+            const { subject, content, graph_id, timezone, backlink_note, tasks } = args;
             const todayDate = getDateForTimezone(timezone);
             const contentParts = [];
             contentParts.push(`#ai-generated\n`);
-            contentParts.push(`- [[${tag}]]\n`);
+            contentParts.push(`- [[${backlink_note}]]\n`);
             const contentLines = content.split('\n');
             const indentedContent = contentLines.map(line => `  ${line}`).join('\n');
             contentParts.push(indentedContent);
@@ -686,14 +686,14 @@ export function registerTools(server, dbPath) {
                         date: todayDate,
                         text: `[[${subject}]]`,
                         transform_type: "list-append",
-                        list_name: `[[${tag}]]`,
+                        list_name: `[[${backlink_note}]]`,
                     }),
                 });
                 if (!dailyNoteResponse.ok) {
                     const errorText = await dailyNoteResponse.text();
                     console.error(`Failed to append to daily notes: ${dailyNoteResponse.status}, ${errorText}`);
                 }
-                const message = `Note "${subject}" created with tag [[${tag}]]${tasks?.length ? ` and ${tasks.length} task(s)` : ''} and linked in daily notes`;
+                const message = `Note "${subject}" created with backlink to [[${backlink_note}]]${tasks?.length ? ` and ${tasks.length} task(s)` : ''} and linked in daily notes`;
                 return {
                     content: [
                         {

package/dist/utils.d.ts

@@ -1,11 +1,20 @@
 /**
  * Utility functions for the Reflect MCP Server
  */
-export declare const DEFAULT_DB_PATH = "~/Library/Application Support/Reflect/File System/000/t/00/00000000";
 /**
  * Expands ~ to the user's home directory
  */
 export declare function expandPath(filePath: string): string;
+/**
+ * Searches for the Reflect local database file
+ * Returns the first valid database path found, or null if not found
+ */
+export declare function findLocalDatabase(): string | null;
+/**
+ * Gets the default database path, searching for it if not provided
+ */
+export declare function getDefaultDbPath(): string;
+export declare const DEFAULT_DB_PATH: string;
 /**
  * Strips HTML tags from a string, converting <br> to newlines
  */

package/dist/utils.js

@@ -3,8 +3,9 @@
  */
 import * as path from "path";
 import * as os from "os";
-// Reflect local database path
-export const DEFAULT_DB_PATH = "~/Library/Application Support/Reflect/File System/000/t/00/00000000";
+import * as fs from "fs";
+// Base path for Reflect local database
+const REFLECT_BASE_PATH = "~/Library/Application Support/Reflect/File System";
 /**
  * Expands ~ to the user's home directory
  */
@@ -14,6 +15,72 @@ export function expandPath(filePath) {
     }
     return filePath;
 }
+/**
+ * Searches for the Reflect local database file
+ * Returns the first valid database path found, or null if not found
+ */
+export function findLocalDatabase() {
+    const basePath = expandPath(REFLECT_BASE_PATH);
+    if (!fs.existsSync(basePath)) {
+        return null;
+    }
+    // Search for database files in the File System directory
+    // Structure is typically: File System/XXX/t/XX/XXXXXXXX
+    try {
+        const entries = fs.readdirSync(basePath);
+        for (const entry of entries) {
+            const entryPath = path.join(basePath, entry);
+            const tPath = path.join(entryPath, "t");
+            if (fs.existsSync(tPath) && fs.statSync(tPath).isDirectory()) {
+                // Look for subdirectories in t/
+                const tEntries = fs.readdirSync(tPath);
+                for (const tEntry of tEntries) {
+                    const subPath = path.join(tPath, tEntry);
+                    if (fs.statSync(subPath).isDirectory()) {
+                        // Look for database files (8-char hex names)
+                        const dbFiles = fs.readdirSync(subPath);
+                        for (const dbFile of dbFiles) {
+                            const dbPath = path.join(subPath, dbFile);
+                            // Check if it's a valid SQLite database (starts with SQLite header)
+                            if (fs.statSync(dbPath).isFile()) {
+                                try {
+                                    const header = Buffer.alloc(16);
+                                    const fd = fs.openSync(dbPath, 'r');
+                                    fs.readSync(fd, header, 0, 16, 0);
+                                    fs.closeSync(fd);
+                                    // SQLite files start with "SQLite format 3"
+                                    if (header.toString('utf8', 0, 15) === 'SQLite format 3') {
+                                        return dbPath;
+                                    }
+                                }
+                                catch {
+                                    // Not a readable file, skip
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+/**
+ * Gets the default database path, searching for it if not provided
+ */
+export function getDefaultDbPath() {
+    const found = findLocalDatabase();
+    if (found) {
+        return found;
+    }
+    // Fallback to a common path pattern
+    return expandPath("~/Library/Application Support/Reflect/File System/000/t/00/00000000");
+}
+// For backwards compatibility
+export const DEFAULT_DB_PATH = getDefaultDbPath();
 /**
  * Strips HTML tags from a string, converting <br> to newlines
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reflect-mcp",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "description": "MCP server for Reflect Notes - connect your notes to Claude Desktop. Just run: npx reflect-mcp",
   "type": "module",
   "main": "dist/server.js",
@@ -39,7 +39,7 @@
     "@modelcontextprotocol/sdk": "^1.25.1",
     "better-sqlite3": "^11.10.0",
     "fastmcp": "^3.25.4",
-    "reflect-mcp": "^1.0.3",
+    "reflect-mcp": "^1.0.10",
     "zod": "^4.1.13"
   },
   "devDependencies": {