Obsidian
API actions for the Obsidian integration.
Obsidian
Create, update, append to, list, and delete notes in your Obsidian vault.
Append to note
Add content to the end of an existing note in your Obsidian vault.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
note_id | string | Yes | The note's file path in your vault, for example 'Projects/My Note.md'. This is the 'id' returned when you create or list notes. |
content | string | Yes | The Markdown content to add to the end of the note. |
Response
{
"appended": true,
"id": "Projects/My Note.md"
}Create note
Create a new note in your Obsidian vault.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
title | string | Yes | The title for the new note. This also becomes the note's file name. |
content | string | No | The content of the note, written in Markdown. Leave blank to create an empty note. |
folder | string | No | The folder in your vault to save the note in, for example 'Projects'. Leave blank to save it at the top level of the vault. |
Response
{
"folder": "Projects",
"id": "Projects/My Note.md",
"title": "My Note"
}Delete note
Delete a note from your Obsidian vault.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
note_id | string | Yes | The note's file path in your vault, for example 'Projects/My Note.md'. This is the 'id' returned when you create or list notes. |
Response
{
"deleted": true,
"id": "Projects/My Note.md"
}List notes
List the notes in your Obsidian vault.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
folder | string | No | Only list notes inside this folder, for example 'Projects'. Leave blank to list notes at the top level of your vault. |
limit | number | No | The maximum number of notes to return. |
Response
{
"items": [
"Daily Notes/2026-07-07.md",
"Projects/My Note.md"
]
}Update note
Replace the entire contents of an existing note in your Obsidian vault.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
note_id | string | Yes | The note's file path in your vault, for example 'Projects/My Note.md'. This is the 'id' returned when you create or list notes. |
content | string | Yes | The new content for the note, written in Markdown. This replaces everything currently in the note. |
Response
{
"id": "Projects/My Note.md"
}