| name | list-projects |
| description | Lists all projects with stored memories for the current user, showing memory counts and last activity dates. Use when checking which projects have memories, comparing memory distribution across repos, or finding a specific project scope. |
Mem0 List Projects
Show all known project scopes for the current user.
Execution
Step 1: Fetch memories to discover app_ids
There is no dedicated "list projects" API endpoint. Discover projects by fetching
the user's memories across all scopes.
Important: A filter with only user_id triggers implicit null scoping — it
excludes memories that have a non-null app_id. Run two queries and merge:
- Null-scoped:
get_memories with filters={"AND": [{"user_id": "<active_user_id>"}]}, page_size=200
— catches memories without app_id
- App-scoped:
get_memories with filters={"AND": [{"user_id": "<active_user_id>"}, {"app_id": {"exists": true}}]}, page_size=200
— catches memories with any app_id
Run both calls in parallel. Merge results, deduplicate by memory id.
If either response indicates more pages, paginate (up to 1000 total).
Step 2: Extract distinct projects
For each memory, determine project by:
- Top-level
app_id field (preferred)
metadata.project_id (legacy memories)metadata.project (oldest format)"(unscoped)" if none found
Group by resolved project name. For each project, count:
- Total memories
- Most recent
created_at date
- Top 3
metadata.type values by frequency
Step 3: Display
## mem0 projects
<app_id_1> <count> memories (last: <date>) ← current
<app_id_2> <count> memories (last: <date>)
<N> projects, <M> total memories
Mark current project with ← current. Sort by memory count descending.
Step 4: Empty state
If zero memories found:
No projects found. Run /mem0:onboard to get started.
