mcpField
L
list-projects

list-projects

github.com/mem0aiAgent workflows68.0k92 installsUpdated 2d ago
Repository

About list-projects

A Mem0 skill that discovers and lists the current user’s project scopes by examining their memories, including scoped and unscoped records.

Key features

  1. 01Discover projects from memories
  2. 02Merge and deduplicate query results
  3. 03Count memories and show latest dates
  4. 04List top metadata types per project

Use cases

  1. 01See known Mem0 project scopes
  2. 02Compare memory counts across projects
  3. 03Find each project’s latest memory activity

MCP support

Uses Mem0 MCP get_memories calls to discover project scopes from memory records.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/mem0ai/mem0 --skill list-projects

After installing, type/list-projectsin Claude Code to confirm it loaded.

Details

From the project README

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:

  1. Null-scoped: get_memories with filters={"AND": [{"user_id": "<active_user_id>"}]}, page_size=200 — catches memories without app_id
  2. 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:

  1. Top-level app_id field (preferred)
  2. metadata.project_id (legacy memories)
  3. metadata.project (oldest format)
  4. "(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.

Comments

Markdown supported