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