obsidian_search_notes

Obsidian · macOS · Windows

Effect: read (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

Searches the notes of an Obsidian vault by text (`query`: note title and text, case-insensitive), by tag (`tag`: inline #tags and frontmatter tags; a tag also matches its nested tags), or both. Returns each note's path inside the vault, title, first matching line and tags, sorted by path, `limit` per page; when has_more is true, pass next_offset as `offset` for the next page. Reads the Markdown files: Obsidian does not need to be running.

Required inputs

No required inputs are declared in this platform's schema. Optional selectors and runtime requirements may still apply.

Permissions and confirmation

No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real 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": {
    "limit": {
      "description": "Notes per page (default 20, max 100).",
      "type": "integer"
    },
    "offset": {
      "description": "Notes to skip (default 0): the next_offset of the previous page.",
      "type": "integer"
    },
    "query": {
      "description": "Text to find in note titles and text. Optional when `tag` is given.",
      "type": "string"
    },
    "tag": {
      "description": "Tag to match, with or without #. Optional when `query` is given.",
      "type": "string"
    },
    "vault": {
      "description": "Vault name or id from obsidian_list_vaults. Optional when there is only one vault.",
      "type": "string"
    }
  },
  "required": [],
  "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.

{
  "limit": 20,
  "query": "launch checklist",
  "tag": "project",
  "vault": "Demo Vault"
}

Windows