AptlyStar

Obsidian

Interact with your Obsidian vault via the Local REST API

Instructions d'utilisation

Read, create, update, search, and delete notes in your Obsidian vault. Manage periodic notes, execute commands, and patch content at specific locations. Requires the Obsidian Local REST API plugin.

Outils

obsidian_append_active

Append content to the currently active file in Obsidian

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiAPI key from Obsidian Local REST API plugin settings
baseUrlstringOuiBase URL for the Obsidian Local REST API
contentstringOuiMarkdown content to append to the active file

Sortie

ParamètreTypeDescription
appendedbooleanWhether content was successfully appended

obsidian_append_note

Append content to an existing note in your Obsidian vault

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiAPI key from Obsidian Local REST API plugin settings
baseUrlstringOuiBase URL for the Obsidian Local REST API
filenamestringOuiPath to the note relative to vault root (e.g. "folder/note.md")
contentstringOuiMarkdown content to append to the note

Sortie

ParamètreTypeDescription
filenamestringPath of the note
appendedbooleanWhether content was successfully appended

obsidian_append_periodic_note

Append content to the current periodic note (daily, weekly, monthly, quarterly, or yearly). Creates the note if it does not exist.

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiAPI key from Obsidian Local REST API plugin settings
baseUrlstringOuiBase URL for the Obsidian Local REST API
periodstringOuiPeriod type: daily, weekly, monthly, quarterly, or yearly
contentstringOuiMarkdown content to append to the periodic note

Sortie

ParamètreTypeDescription
periodstringPeriod type of the note
appendedbooleanWhether content was successfully appended

obsidian_create_note

Create or replace a note in your Obsidian vault

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiAPI key from Obsidian Local REST API plugin settings
baseUrlstringOuiBase URL for the Obsidian Local REST API
filenamestringOuiPath for the note relative to vault root (e.g. "folder/note.md")
contentstringOuiMarkdown content for the note

Sortie

ParamètreTypeDescription
filenamestringPath of the created note
createdbooleanWhether the note was successfully created

obsidian_delete_note

Delete a note from your Obsidian vault

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiAPI key from Obsidian Local REST API plugin settings
baseUrlstringOuiBase URL for the Obsidian Local REST API
filenamestringOuiPath to the note to delete relative to vault root

Sortie

ParamètreTypeDescription
filenamestringPath of the deleted note
deletedbooleanWhether the note was successfully deleted

obsidian_execute_command

Execute a command in Obsidian (e.g. open daily note, toggle sidebar)

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiAPI key from Obsidian Local REST API plugin settings
baseUrlstringOuiBase URL for the Obsidian Local REST API
commandIdstringOuiID of the command to execute (use List Commands operation to discover available commands)

Sortie

ParamètreTypeDescription
commandIdstringID of the executed command
executedbooleanWhether the command was successfully executed

obsidian_get_active

Retrieve the content of the currently active file in Obsidian

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiAPI key from Obsidian Local REST API plugin settings
baseUrlstringOuiBase URL for the Obsidian Local REST API

Sortie

ParamètreTypeDescription
contentstringMarkdown content of the active file
filenamestringPath to the active file

obsidian_get_note

Retrieve the content of a note from your Obsidian vault

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiAPI key from Obsidian Local REST API plugin settings
baseUrlstringOuiBase URL for the Obsidian Local REST API
filenamestringOuiPath to the note relative to vault root (e.g. "folder/note.md")

Sortie

ParamètreTypeDescription
contentstringMarkdown content of the note
filenamestringPath to the note

obsidian_get_periodic_note

Retrieve the current periodic note (daily, weekly, monthly, quarterly, or yearly)

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiAPI key from Obsidian Local REST API plugin settings
baseUrlstringOuiBase URL for the Obsidian Local REST API
periodstringOuiPeriod type: daily, weekly, monthly, quarterly, or yearly

Sortie

ParamètreTypeDescription
contentstringMarkdown content of the periodic note
periodstringPeriod type of the note

obsidian_list_commands

List all available commands in Obsidian

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiAPI key from Obsidian Local REST API plugin settings
baseUrlstringOuiBase URL for the Obsidian Local REST API

Sortie

ParamètreTypeDescription
commandsjsonList of available commands with IDs and names
↳ idstringCommand identifier
↳ namestringHuman-readable command name

obsidian_list_files

List files and directories in your Obsidian vault

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiAPI key from Obsidian Local REST API plugin settings
baseUrlstringOuiBase URL for the Obsidian Local REST API
pathstringNonDirectory path relative to vault root. Leave empty to list root.

Sortie

ParamètreTypeDescription
filesjsonList of files and directories
↳ pathstringFile or directory path
↳ typestringWhether the entry is a file or directory

obsidian_open_file

Open a file in the Obsidian UI (creates the file if it does not exist)

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiAPI key from Obsidian Local REST API plugin settings
baseUrlstringOuiBase URL for the Obsidian Local REST API
filenamestringOuiPath to the file relative to vault root
newLeafbooleanNonWhether to open the file in a new leaf/tab

Sortie

ParamètreTypeDescription
filenamestringPath of the opened file
openedbooleanWhether the file was successfully opened

obsidian_patch_active

Insert or replace content at a specific heading, block reference, or frontmatter field in the active file

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiAPI key from Obsidian Local REST API plugin settings
baseUrlstringOuiBase URL for the Obsidian Local REST API
contentstringOuiContent to insert at the target location
operationstringOuiHow to insert content: append, prepend, or replace
targetTypestringOuiType of target: heading, block, or frontmatter
targetstringOuiTarget identifier (heading text, block reference ID, or frontmatter field name)
targetDelimiterstringNonDelimiter for nested headings (default: "::")
trimTargetWhitespacebooleanNonWhether to trim whitespace from target before matching (default: false)

Sortie

ParamètreTypeDescription
patchedbooleanWhether the active file was successfully patched

obsidian_patch_note

Insert or replace content at a specific heading, block reference, or frontmatter field in a note

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiAPI key from Obsidian Local REST API plugin settings
baseUrlstringOuiBase URL for the Obsidian Local REST API
filenamestringOuiPath to the note relative to vault root (e.g. "folder/note.md")
contentstringOuiContent to insert at the target location
operationstringOuiHow to insert content: append, prepend, or replace
targetTypestringOuiType of target: heading, block, or frontmatter
targetstringOuiTarget identifier (heading text, block reference ID, or frontmatter field name)
targetDelimiterstringNonDelimiter for nested headings (default: "::")
trimTargetWhitespacebooleanNonWhether to trim whitespace from target before matching (default: false)

Sortie

ParamètreTypeDescription
filenamestringPath of the patched note
patchedbooleanWhether the note was successfully patched

Search for text across notes in your Obsidian vault

Entrée

ParamètreTypeObligatoireDescription
apiKeystringOuiAPI key from Obsidian Local REST API plugin settings
baseUrlstringOuiBase URL for the Obsidian Local REST API
querystringOuiText to search for across vault notes
contextLengthnumberNonNumber of characters of context around each match (default: 100)

Sortie

ParamètreTypeDescription
resultsjsonSearch results with filenames, scores, and matching contexts
↳ filenamestringPath to the matching note
↳ scorenumberRelevance score
↳ matchesjsonMatching text contexts
↳ contextstringText surrounding the match

On this page