Full-text search across the Brain Obsidian vault.

Searches note content for the given query string and returns matching notes with context snippets. Useful for finding notes about a topic, locating references, or discovering related content.

Args: params: Search parameters including query, optional folder scope, and limit.

Returns: JSON with matching notes, each containing path, title, type, match count, and context snippets. Returns an error message if no results found.

List notes in a vault folder with optional filtering by type.

Returns metadata for notes including path, title, type, updated date, and status. Useful for browsing a folder, reviewing inbox contents, or finding all notes of a specific type.

Args: params: List parameters including folder, note_type filter, recursive flag, limit.

Returns: JSON with note metadata list. Filterable by frontmatter type (moc, project, area, resource, archive).

Read the full content of a specific note by path or title.

Returns the complete markdown content including frontmatter, plus extracted metadata (type, wikilinks, updated date).

Args: params: Either a vault-relative path or a note title.

Returns: JSON with content, frontmatter metadata, and extracted wikilinks.

Create a new note in the vault.

By default notes are created in Notes/ per the vault workflow standard. Agent-created notes should always go to Notes/ first; promotion happens during manual vault review.

Args: params: Title, content (full markdown with frontmatter), and target folder.

Returns: Confirmation with the path of the created note, or an error if the note already exists.

Update the content of an existing note.

Replaces the full content. If update_date is True (default), the 'updated' field in frontmatter is set to today's date.

Args: params: Note path or title, new content, and update_date flag.

Returns: Confirmation with the updated path, or an error if not found.

Move a note from one folder to another (e.g., promote from inbox).

Commonly used to promote notes from Notes/ to their final location in a domain folder (Projects, Infrastructure, APIs, etc.).

Args: params: Source path and destination folder.

Returns: Confirmation with old and new paths, or an error.

Find all notes that link to a given note via [[wikilinks]].

Useful for understanding how a note is referenced across the vault, checking if a note is properly linked from MOCs, or mapping relationships between concepts.

Args: params: Title of the note to find backlinks for.

Returns: JSON list of notes that contain [[title]] wikilinks.

Get a high-level overview of the vault structure.

Returns the canonical folder layout, note counts per folder, and the contents of MOC - Home for navigation. Use this as a starting point for exploring the vault.

Returns: JSON with folder statistics, total note count, and MOC - Home content.

List subfolders within a vault directory.

Returns immediate subdirectories and their note counts. Useful for exploring the vault hierarchy before reading specific notes.

Args: folder: Optional vault-relative path. Omit for vault root.

Returns: JSON list of subdirectories with note counts.