Keep/Docs

Search your Keep library

Search Notes and saved Items together. Filter results by source, tag, collection, Project, kind, or state.

Keep searches both Notes and saved Items. It combines exact text matches with meaning-based matches.

Global search is the fastest way to find context or open part of the app.

  1. Press Command K on macOS or Control K on Windows and Linux.
  2. Enter words from the Note, Item, or topic.
  3. Select a result.

Results can include Notes, Items, recent Notes, pages, and actions. Note results can show the Project and the latest contributor. Item results can show the source, tags, and saved date.

Keep checks titles, URLs, Note bodies, Item notes, tags, and saved content. It can find a relevant result even when your search does not contain the exact words in that result.

Long searches are split into useful terms. A distinctive title stays ahead of weaker matches, and cue lists in session summaries help Keep recover a Note from the names or concepts you still remember.

Start a search with one of these filters. Select a suggested value, then enter the rest of your search.

Filter Finds
source: Items from one source or website
tag: or # Notes and Items with one tag
collection: or in: Items in one collection
project: Notes in one Project
kind: Notes with one kind
state: Notes with one state

Use quotation marks around a value that contains spaces.

project:"Keep website" session hooks
tag:research agent memory
kind:handoff state:open
source:youtube transcripts
in:"AI research" evaluation

Filter the Feed

The search field in the Feed searches Items only. Press / to focus it.

The Feed supports free text and these filters:

  • source: for a source or website
  • tag: or # for a tag
  • collection: or in: for a collection

You can combine filters with text.

authentication tag:security in:research
source:github agent tools

The Feed keeps the search and filters in the URL. You can open an Item and move to the previous or next matching Item without losing the search.

Search from the CLI

keep search is the main CLI search command. It searches Notes and Items. In a Git repository, it also uses the repository and current path to rank relevant project context.

keep search "OAuth handoff"
keep notes search "OAuth handoff"
keep items search "OAuth handoff"

Use keep notes search or keep items search when you need one resource type. Note search returns bounded results and accepts the same --project, --path, --exact-project, and --exact-path filters as the main search command. keep context remains a compatibility alias for keep search.

See the CLI guide for output and filtering options.

Search with the API

Use GET /api/search to search Notes and Items together.

curl "https://keep.md/api/search?q=session%20handoff&types=note,item&mode=hybrid" \
  -H "Authorization: Bearer $KEEP_API_KEY"

Use GET /api/notes/search for Notes only. Use GET /api/items/search for Items only. Search mode can be lexical, semantic, or hybrid.

See the API reference for all parameters.

Documentation

Type to search…

↑↓ navigate↵ selectEsc close