Skip to content

list_memories

List all memories that have a specific tag.

Parameters

ParameterTypeRequiredDescription
tagstringYesThe tag to filter by.
limitintegerNoMaximum number of results (1–500, default 100).
cursorstringNoPagination cursor from a previous call.

Behaviour

  • Returns all memories that include the specified tag, along with their keys, values, and full tag lists.
  • Results are paginated — if there are more results, a next_cursor is returned and the caller can request the next page.

Examples

List all my memories tagged "project".
Show me everything tagged "decision".

Pagination

For large tag groups, the agent may make multiple calls automatically, passing the cursor to retrieve subsequent pages.

Hive — shared persistent memory for AI agents