obsidian_write_note

Obsidian · macOS · Windows

Effect: write (strongest supported action). Status: gated.

Gated means the tool requires an installed app, a connected account, permission, or runtime availability. Check those requirements on the listed platform before using it.

macOS

Purpose

Writes a Markdown note in an Obsidian vault. mode="create" writes a new note (missing folders are created); mode="append" adds `content` to the end of an existing note. Called without confirm it returns a preview and writes nothing; pass confirm=true to write. An existing note is never replaced, and Obsidian's settings folder is never written.

Required inputs

path — Path of the note inside the vault, like Projects/Plan.md (.md is added when missing).
content — Markdown text to write.
mode — create: a new note. append: add to the end of an existing note.

Permissions and confirmation

Explicit confirmation parameter: inspect the schema and tool description before any real call. The documentation example keeps confirm false. Obtain user authorization before performing the action.

Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.

Full input schema — macOS

{
  "properties": {
    "confirm": {
      "description": "Must be true to write. Without it the call returns a preview.",
      "type": "boolean"
    },
    "content": {
      "description": "Markdown text to write.",
      "type": "string"
    },
    "mode": {
      "description": "create: a new note. append: add to the end of an existing note.",
      "enum": [
        "create",
        "append"
      ],
      "type": "string"
    },
    "path": {
      "description": "Path of the note inside the vault, like Projects/Plan.md (.md is added when missing).",
      "type": "string"
    },
    "vault": {
      "description": "Vault name or id from obsidian_list_vaults. Optional when there is only one vault.",
      "type": "string"
    }
  },
  "required": [
    "path",
    "content",
    "mode"
  ],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "confirm": false,
  "content": "## Planning meeting\n\n- Can we review the launch checklist on Tuesday?",
  "mode": "create",
  "path": "Meetings/Planning meeting.md",
  "vault": "Demo Vault"
}

Windows