@noteplanco/noteplan-mcp 1.1.7 → 1.1.8

package/dist/tools/templates.js

@@ -3,14 +3,19 @@ import { z } from 'zod';
 import * as store from '../noteplan/unified-store.js';
 import { runAppleScript, escapeAppleScript, APP_NAME } from '../utils/applescript.js';
 import { getNotePlanVersion, MIN_BUILD_RENDER_TEMPLATE } from '../utils/version.js';
+import { tryEmbedQuery, searchTemplateDocs, textSearchTemplateDocs, getDocChunk } from '../noteplan/template-docs.js';
 export const templatesSchema = z.object({
-    action: z.enum(['list', 'render']).describe('Action to perform'),
+    action: z.enum(['list', 'render', 'search_docs', 'get_doc']).describe('Action to perform'),
     templateTitle: z.string().optional().describe('Template title — used by render (loads a saved template by title)'),
     content: z.string().optional().describe('Raw template content string — used by render (renders arbitrary template code for debugging)'),
     folder: z.string().optional().describe('Template subfolder — used by list (default: @Templates)'),
     limit: z.number().min(1).max(200).optional().default(50).describe('Maximum results — used by list'),
     offset: z.number().min(0).optional().default(0).describe('Pagination offset — used by list'),
     cursor: z.string().optional().describe('Cursor from previous page — used by list'),
+    query: z.string().optional().describe('Search query — used by search_docs'),
+    includeContent: z.boolean().optional().describe('Include full chunk text in results — used by search_docs'),
+    noteTitle: z.string().optional().describe('Doc note title — used by get_doc (from search_docs results)'),
+    chunkIndex: z.number().optional().describe('Chunk index — used by get_doc (from search_docs results, default 0)'),
 });
 // ── Frontmatter helpers ──
 function extractFrontmatter(content) {
@@ -62,6 +67,7 @@ export function listTemplates(params) {
     const nextCursor = hasMore ? String(offset + page.length) : null;
     return {
         success: true,
+        tip: 'Before writing or editing templates, use action "search_docs" with a query to search the built-in documentation for syntax, helpers, DataStore API, and examples.',
         count: page.length,
         totalCount: notes.length,
         offset,
@@ -115,6 +121,7 @@ export function renderTemplate(params) {
             if (parsed.success === true) {
                 return {
                     success: true,
+                    tip: 'Use action "search_docs" with a query to search the built-in documentation for template syntax, helpers, DataStore API, and examples.',
                     renderedContent: parsed.rendered ?? raw,
                     source: content ? 'raw_content' : 'saved_template',
                     templateTitle: templateTitle || undefined,
@@ -142,4 +149,69 @@ export function renderTemplate(params) {
         };
     }
 }
+// ── Get full doc chunk ──
+export function getDoc(params) {
+    const noteTitle = params.noteTitle?.trim();
+    if (!noteTitle) {
+        return { success: false, error: 'noteTitle is required for get_doc' };
+    }
+    const chunkIndex = params.chunkIndex ?? 0;
+    const chunk = getDocChunk(noteTitle, chunkIndex);
+    if (!chunk) {
+        return {
+            success: false,
+            error: `No doc chunk found for noteTitle="${noteTitle}" chunkIndex=${chunkIndex}`,
+        };
+    }
+    return {
+        success: true,
+        noteTitle: chunk.noteTitle,
+        chunkIndex: chunk.chunkIndex,
+        totalChunks: chunk.totalChunks,
+        content: chunk.content,
+    };
+}
+// ── Search template docs ──
+export async function searchDocs(params) {
+    const query = params.query?.trim();
+    if (!query) {
+        return {
+            success: false,
+            error: 'query is required for search_docs',
+        };
+    }
+    const searchOptions = {
+        limit: params.limit ?? 5,
+        includeContent: params.includeContent,
+    };
+    try {
+        const embedResult = await tryEmbedQuery(query);
+        if (embedResult.ok) {
+            // Semantic search using embeddings
+            const matches = searchTemplateDocs(embedResult.vector, searchOptions);
+            return {
+                success: true,
+                query,
+                count: matches.length,
+                embeddingSource: embedResult.source,
+                matches,
+            };
+        }
+        // No embedding source available — fall back to text search
+        const matches = textSearchTemplateDocs(query, searchOptions);
+        return {
+            success: true,
+            query,
+            count: matches.length,
+            embeddingSource: 'text',
+            matches,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Template doc search failed',
+        };
+    }
+}
 //# sourceMappingURL=templates.js.map

package/dist/tools/templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/tools/templates.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/tools/templates.ts"],"names":[],"mappings":"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"}

package/dist/utils/version.d.ts

@@ -5,6 +5,7 @@ export interface NotePlanVersion {
 }
 export declare const MIN_BUILD_ADVANCED_FEATURES = 1300;
 export declare const MIN_BUILD_RENDER_TEMPLATE = 1400;
+export declare const MIN_BUILD_EMBED_TEXT = 1490;
 export declare const MIN_BUILD_CREATE_BACKUP = 1492;
 export declare function getNotePlanVersion(forceRefresh?: boolean): NotePlanVersion;
 export declare function isAdvancedFeaturesAvailable(forceRefresh?: boolean): boolean;

package/dist/utils/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,aAAa,GAAG,OAAO,GAAG,SAAS,CAAC;CAC7C;AAGD,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAGhD,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAG9C,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAmE5C,wBAAgB,kBAAkB,CAAC,YAAY,UAAQ,GAAG,eAAe,CAUxE;AAED,wBAAgB,2BAA2B,CAAC,YAAY,UAAQ,GAAG,OAAO,CAGzE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAID,wBAAgB,mBAAmB,IAAI,MAAM,CAU5C"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,aAAa,GAAG,OAAO,GAAG,SAAS,CAAC;CAC7C;AAGD,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAGhD,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAG9C,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAGzC,eAAO,MAAM,uBAAuB,OAAO,CAAC;AA6G5C,wBAAgB,kBAAkB,CAAC,YAAY,UAAQ,GAAG,eAAe,CAUxE;AAED,wBAAgB,2BAA2B,CAAC,YAAY,UAAQ,GAAG,OAAO,CAGzE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAID,wBAAgB,mBAAmB,IAAI,MAAM,CAU5C"}

package/dist/utils/version.js

@@ -6,47 +6,91 @@ import * as path from 'path';
 export const MIN_BUILD_ADVANCED_FEATURES = 1300;
 // Build that ships the renderTemplate AppleScript command
 export const MIN_BUILD_RENDER_TEMPLATE = 1400;
+// Build that ships the embedText AppleScript command
+export const MIN_BUILD_EMBED_TEXT = 1490;
 // Build that ships the createBackup AppleScript command
 export const MIN_BUILD_CREATE_BACKUP = 1492;
 const CACHE_TTL_MS = 60_000;
 let cachedVersion = null;
 let cachedAt = 0;
+// AppleScript may resolve the app by CFBundleName or by .app filename depending on macOS version.
+// MAS installs can use the store marketing name as the .app folder name, so we try multiple names.
+const APPLESCRIPT_APP_NAMES = [
+    'NotePlan',
+    'NotePlan 3',
+    'NotePlan - To-Do List & Notes',
+];
 function detectViaAppleScript() {
-    try {
-        // Check if NotePlan is running first to avoid launching it as a side effect
-        const isRunning = execFileSync('osascript', ['-e', 'application "NotePlan" is running'], {
-            encoding: 'utf-8',
-            stdio: ['pipe', 'pipe', 'pipe'],
-            timeout: 3_000,
-        }).trim();
-        if (isRunning !== 'true')
-            return null;
-        const raw = execFileSync('osascript', ['-e', 'tell application "NotePlan" to getVersion'], {
-            encoding: 'utf-8',
-            stdio: ['pipe', 'pipe', 'pipe'],
-            timeout: 5_000,
-        }).trim();
-        const parsed = JSON.parse(raw);
-        if (typeof parsed.version === 'string' && typeof parsed.build === 'number') {
-            return { version: parsed.version, build: parsed.build, source: 'applescript' };
+    for (const appName of APPLESCRIPT_APP_NAMES) {
+        try {
+            const isRunning = execFileSync('osascript', ['-e', `application "${appName}" is running`], {
+                encoding: 'utf-8',
+                stdio: ['pipe', 'pipe', 'pipe'],
+                timeout: 3_000,
+            }).trim();
+            if (isRunning !== 'true')
+                continue;
+            const raw = execFileSync('osascript', ['-e', `tell application "${appName}" to getVersion`], {
+                encoding: 'utf-8',
+                stdio: ['pipe', 'pipe', 'pipe'],
+                timeout: 5_000,
+            }).trim();
+            const parsed = JSON.parse(raw);
+            if (typeof parsed.version === 'string' && typeof parsed.build === 'number') {
+                return { version: parsed.version, build: parsed.build, source: 'applescript' };
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(`[noteplan-mcp] AppleScript detection failed for "${appName}": ${msg}`);
+            if (msg.includes('not allowed') || msg.includes('permission') || msg.includes('1743') || msg.includes('assistive')) {
+                console.error('[noteplan-mcp] Hint: The parent app (e.g. Claude Desktop, Terminal) may need Automation permission for NotePlan. Check System Settings > Privacy & Security > Automation.');
+                return null; // Permission issue — no point trying other names
+            }
         }
     }
-    catch {
-        // App not running or command not available
-    }
+    console.error('[noteplan-mcp] AppleScript: NotePlan not found running under any known name.');
     return null;
 }
 const KNOWN_APP_PATHS = [
     '/Applications/NotePlan 3.app',
     '/Applications/NotePlan.app',
+    '/Applications/NotePlan - To-Do List & Notes.app',
     path.join(process.env.HOME ?? '', 'Applications/NotePlan 3.app'),
     path.join(process.env.HOME ?? '', 'Applications/NotePlan.app'),
+    path.join(process.env.HOME ?? '', 'Applications/NotePlan - To-Do List & Notes.app'),
     // Setapp
     '/Applications/Setapp/NotePlan 3.app',
     '/Applications/Setapp/NotePlan.app',
 ];
 function detectViaPlist() {
-    for (const appPath of KNOWN_APP_PATHS) {
+    // First try hardcoded known paths
+    const result = readVersionFromAppPath(KNOWN_APP_PATHS);
+    if (result)
+        return result;
+    // Fallback: use mdfind (Spotlight) to locate the app bundle dynamically
+    console.error(`[noteplan-mcp] Plist: app not found at known paths, trying mdfind...`);
+    try {
+        const mdfindResult = execFileSync('mdfind', ['kMDItemCFBundleIdentifier == "co.noteplan.NotePlan3" || kMDItemCFBundleIdentifier == "co.noteplan.NotePlan-setapp" || kMDItemCFBundleIdentifier == "co.noteplan.NotePlan"'], {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 5_000,
+        }).trim();
+        if (mdfindResult) {
+            const discoveredPaths = mdfindResult.split('\n').filter(Boolean);
+            console.error(`[noteplan-mcp] mdfind discovered: ${discoveredPaths.join(', ')}`);
+            const found = readVersionFromAppPath(discoveredPaths);
+            if (found)
+                return found;
+        }
+    }
+    catch (err) {
+        console.error(`[noteplan-mcp] mdfind fallback failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    return null;
+}
+function readVersionFromAppPath(appPaths) {
+    for (const appPath of appPaths) {
         const plistPath = path.join(appPath, 'Contents/Info.plist');
         if (!fs.existsSync(plistPath))
             continue;
@@ -66,8 +110,8 @@ function detectViaPlist() {
                 return { version, build, source: 'plist' };
             }
         }
-        catch {
-            // plist read failed for this path, try next
+        catch (err) {
+            console.error(`[noteplan-mcp] Plist read failed for ${appPath}: ${err instanceof Error ? err.message : String(err)}`);
         }
     }
     return null;

package/dist/utils/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"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"}

package/docs/x-callback-url.md

@@ -0,0 +1,318 @@
+# NotePlan x-callback-url Reference
+
+NotePlan supports the `noteplan://x-callback-url/` URL scheme for automation, deep linking, and integration with other apps. These URLs work on both macOS and iOS.
+
+## Base URL Format
+
+```
+noteplan://x-callback-url/<action>?<param1>=<value1>&<param2>=<value2>
+```
+
+All parameter values must be **percent-encoded** (URL-encoded). Use `%20` for spaces, `%0A` for newlines, `%23` for `#`, etc.
+
+## x-callback-url Support
+
+All actions support the standard [x-callback-url](http://x-callback-url.com) parameters:
+- **x-success** — URL to open when the action completes successfully. For `noteInfo`, the callback receives `?path=<path>&name=<name>`.
+
+---
+
+## Note Targeting Parameters
+
+Many actions need to identify which note to act on. Use **one** of these parameters:
+
+| Parameter | Description | Example |
+|-----------|-------------|---------|
+| `noteDate` | Date of a calendar note. Accepts `YYYYMMDD`, `YYYY-MM-DD`, `today`, `tomorrow`, `yesterday` | `noteDate=20250217` |
+| `noteTitle` | Title of a project note (case-sensitive by default) | `noteTitle=My%20Note` |
+| `fileName` | Filename/path of a note (with extension) | `fileName=Projects/todo.md` |
+| `id` | Supabase note ID | `id=abc123` |
+
+Additional targeting options:
+- **caseSensitive** — `true` (default) or `false`, applies to `noteTitle` lookups
+- **heading** / **subheading** — Jump to a specific heading within the note
+
+---
+
+## Actions
+
+### openNote
+
+Open an existing note. If the note doesn't exist, it creates one (using `noteTitle` as the title).
+
+```
+noteplan://x-callback-url/openNote?noteTitle=Meeting%20Notes
+noteplan://x-callback-url/openNote?noteDate=today
+noteplan://x-callback-url/openNote?fileName=Projects/roadmap.md
+```
+
+| Parameter | Description |
+|-----------|-------------|
+| `noteDate` / `noteTitle` / `fileName` | Which note to open (see Note Targeting) |
+| `heading` | Scroll to and highlight this heading |
+| `subWindow` | `yes` to open in a new window (macOS) |
+| `splitView` | `yes` to open in split view (macOS) |
+| `reuseSplitView` | `yes` to reuse an existing split view |
+| `useExistingSubWindow` | `yes` to reuse an existing sub window (macOS) |
+| `view` | `daily` or `week` — override the view for calendar notes (macOS) |
+| `timeframe` | `day`, `week`, `month`, `quarter`, `year` |
+| `parent` | Teamspace/space parent identifier |
+| `stayInSpace` | `yes` to stay in the current teamspace context |
+| `highlightStart` | Character offset to highlight |
+| `highlightLength` | Length of highlight range |
+| `editorID` | Target a specific editor pane |
+| `showEventsOnly` | `yes` to show only calendar events (iOS) |
+| `shouldOpenTrashedNotes` | `yes` to allow opening trashed notes |
+
+---
+
+### addText
+
+Append or prepend text to an existing note.
+
+```
+noteplan://x-callback-url/addText?noteDate=today&text=*%20Buy%20groceries&mode=append&openNote=no
+noteplan://x-callback-url/addText?noteTitle=Journal&text=Had%20a%20great%20day&mode=append
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `noteDate` / `noteTitle` / `fileName` | Yes | Which note to modify |
+| `text` | Yes | The text to add (percent-encoded) |
+| `mode` | No | `append` (default) or `prepend` |
+| `openNote` | No | `yes` to open the note after adding text, `no` (default) to stay in current app |
+
+**Tips:**
+- Use `%0A` for newlines in the text parameter
+- Prefix tasks with `*%20` for bullet/task format (e.g., `text=*%20My%20task`)
+- Use `mode=prepend` to add at the top of the note (after the heading for calendar notes)
+
+---
+
+### addNote
+
+Create a new project note.
+
+```
+noteplan://x-callback-url/addNote?noteTitle=Weekly%20Review&text=##%20Wins&openNote=yes
+noteplan://x-callback-url/addNote?noteTitle=Meeting&text=Attendees&folder=Work
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `noteTitle` | Yes | Title for the new note (a `#` heading is auto-prepended if missing) |
+| `text` | No | Body content of the note |
+| `folder` | No | Folder to create the note in (e.g., `Projects`, `Work/Active`) |
+| `openNote` | No | `yes` to open after creation |
+| `subWindow` | No | `yes` to open in a new window (macOS) |
+| `splitView` | No | `yes` to open in split view (macOS) |
+
+---
+
+### addQuickTask (iOS only)
+
+Opens the quick-add task editor, optionally pre-targeted to a specific note.
+
+```
+noteplan://x-callback-url/addQuickTask?destination=today
+noteplan://x-callback-url/addQuickTask?destination=tomorrow&heading=Tasks&position=beginning
+noteplan://x-callback-url/addQuickTask?destination=customnote&noteTitle=Inbox
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `destination` | No | `today` (default), `tomorrow`, `yesterday`, `thisWeek`, `nextWeek`, `thisMonth`, `nextMonth`, `thisQuarter`, `nextQuarter`, `thisYear`, `nextYear`, or `customnote` |
+| `timeframe` | No | `day` (default), `week`, `month`, `quarter`, `year` — sets the note timeframe |
+| `noteTitle` | No | Required when `destination=customnote` — the project note title |
+| `heading` | No | Target heading section in the note |
+| `position` | No | `beginning` (default) or `end` |
+| `content` | No | Pre-fill the task content |
+| `input` | No | `text` (default), `voice`, or `drawing` |
+| `lineType` | No | `task` (default), `bullet`, `quote`, `empty`, `checklist` |
+| `skipPostProcessing` | No | `true` (default) or `false` — skip AI post-processing for voice |
+| `postProcessing` | No | Pre-selected post-processing mode for voice |
+| `fast` | No | `true` to skip cache loading (used by widgets) |
+
+---
+
+### deleteNote
+
+Move a note to trash (project notes) or clear content (calendar notes).
+
+```
+noteplan://x-callback-url/deleteNote?noteTitle=Old%20Note
+noteplan://x-callback-url/deleteNote?noteDate=20250101
+noteplan://x-callback-url/deleteNote?fileName=Projects/archive.md
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `noteDate` / `noteTitle` / `fileName` | Yes | Which note to delete |
+
+---
+
+### search
+
+Open the search view with a keyword or open a saved filter.
+
+```
+noteplan://x-callback-url/search?text=meeting%20notes&view=calendar
+noteplan://x-callback-url/search?filter=Overdue%20Tasks
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `text` | No* | Search keyword |
+| `filter` | No* | Name of a saved filter/review to open |
+| `view` | No | `calendar` or `notes` — which view to search in |
+
+*One of `text` or `filter` is required.
+
+---
+
+### selectTag
+
+Filter notes by a tag (hashtag or mention).
+
+```
+noteplan://x-callback-url/selectTag?name=%23project
+noteplan://x-callback-url/selectTag?name=%40waiting
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `name` | Yes | The tag to filter by, including the `#` or `@` prefix |
+
+---
+
+### runPlugin
+
+Execute a plugin command.
+
+```
+noteplan://x-callback-url/runPlugin?pluginID=jgclark.NoteHelpers&command=jump%20to%20heading
+noteplan://x-callback-url/runPlugin?pluginID=my.plugin&command=doThing&arg0=hello&arg1=world
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `pluginID` | Yes | The plugin identifier |
+| `command` | Yes | The command name to execute |
+| `arg0`, `arg1`, ... | No | Positional arguments passed to the plugin command |
+
+---
+
+### installPlugin
+
+Install or update a plugin from the online repository.
+
+```
+noteplan://x-callback-url/installPlugin?plugin_id=jgclark.NoteHelpers
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `plugin_id` | Yes | Plugin ID to install (also accepts `pluginID`, `pluginId`, `id`) |
+
+---
+
+### openView
+
+Open a named view in NotePlan.
+
+```
+noteplan://x-callback-url/openView?name=review
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `name` | Yes | The view name to open |
+
+---
+
+### toggleSidebar
+
+Toggle sidebar visibility.
+
+```
+noteplan://x-callback-url/toggleSidebar
+noteplan://x-callback-url/toggleSidebar?forceCollapse=yes
+noteplan://x-callback-url/toggleSidebar?forceOpen=yes
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `forceCollapse` | No | `yes` to force the sidebar closed |
+| `forceOpen` | No | `yes` to force the sidebar open |
+| `animated` | No | `no` to skip animation |
+
+---
+
+### setTheme
+
+Set the active theme.
+
+```
+noteplan://x-callback-url/setTheme?name=Nord&mode=dark
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `name` | Yes | Theme filename |
+| `mode` | No | `light`, `dark`, or `auto` (default) |
+
+---
+
+### closePluginWindow (macOS only)
+
+Close plugin HTML windows.
+
+```
+noteplan://x-callback-url/closePluginWindow?windowID=my-window
+noteplan://x-callback-url/closePluginWindow?title=Dashboard
+noteplan://x-callback-url/closePluginWindow
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `windowID` | No | Specific window ID to close |
+| `title` | No | Close window matching this title |
+
+If no parameters are given, **all** plugin windows are closed.
+
+---
+
+### noteInfo
+
+Returns information about the currently open note via the `x-success` callback.
+
+```
+noteplan://x-callback-url/noteInfo?x-success=myapp://callback
+```
+
+The `x-success` URL receives `?path=<encoded_path>&name=<encoded_name>`.
+
+---
+
+## Encoding Examples
+
+| Content | Encoded |
+|---------|---------|
+| `Buy groceries` | `Buy%20groceries` |
+| `# Heading` | `%23%20Heading` |
+| Newline | `%0A` |
+| `Task & notes` | `Task%20%26%20notes` |
+| `[Link](url)` | `%5BLink%5D(url)` |
+
+### Multi-line text example
+
+```
+noteplan://x-callback-url/addText?noteDate=today&text=%23%23%20Morning%0A-%20Coffee%0A-%20Read%20news&mode=prepend&openNote=no
+```
+
+This prepends to today's note:
+```
+## Morning
+- Coffee
+- Read news
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noteplanco/noteplan-mcp",
-  "version": "1.1.7",
+  "version": "1.1.8",
   "description": "MCP server for NotePlan note and task management",
   "main": "dist/index.js",
   "type": "module",