search_text

Literal text search across vault notes (BM25-ranked). Supports case_sensitive and whole_word; scoped to an optional root folder. response_format=concise (legacy alias verbosity=terse) drops line/col, keeping path/score/snippet.

Domain	search
Scopes	read:notes
Access	read
Tags	read-only, domain:search
Profile	core, full

Annotations

Annotation	Value
Read-only	yes
Destructive	no
Idempotent	no
Accepts an idempotency key	no

Idempotent is the advisory MCP idempotentHint. Destructive is also yes for a tool that asks for confirmation only on some calls.

Confirmation (human in the loop)

No human confirmation is required to call this tool.

Input

Parameter	Type	Required	Default	Description
vault	string		—	Vault id. May be omitted when only one vault is available. length 1–64; pattern ^[a-z0-9_-]+$
query	string	yes	—	length ≥ 1
case_sensitive	boolean		false	—
whole_word	boolean		false	—
root	string		—	length 1–1024
limit	integer		—	range 1–1000
cursor	string		—	—
response_format	enum		—	concise returns only the high-signal fields; detailed (the shipped default) returns the full payload. Errors and safety warnings are never trimmed. When omitted, the server’s tools.defaults.responseFormat applies. One of: "concise", "detailed"
verbosity	enum		—	Legacy alias for response_format: terse = concise, full = detailed. One of: "full", "terse"

Output

Field	Type	Always present	Description
vault	string	yes	—
mode_used	enum	yes	One of: "text"
items	object[]	yes	—
items[].path	string	yes	—
items[].score	number	yes	—
items[].snippet	string	yes	—
items[].line	number		—
items[].col	number		—
total	number	yes	—
next_cursor	string		—

Related tools

Other tools in the search domain: query_datacore, search, search_and_read, search_dql, search_jsonlogic, search_omnisearch, search_regex, search_semantic, search_vault.

Back to the tool catalog.