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 Markdown. It combines exact text matches with meaning-based matches, so a vague memory can still find the right item.

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. Results for notes can show the Project and the latest contributor. Results for items 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 Saved

The search field in Saved searches items only. Press / to focus it.

Saved 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

Saved 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 across your library. Project and path filters remain available for advanced workflows, but this command does not detect them automatically.

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. Search results for notes are bounded and accept the same --project, --path, --exact-project, and --exact-path filters as the main search command. keep context is a separate compatibility command for advanced Git project workflows. It detects the current project and path before it searches.

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