New to Claude Skills? Learn how to install them →

mem0ai on GitHub

List Projects

Free

Easily view all your project scopes and memory counts.

by mem0ai63k stars on mem0ai/mem0
1 views
Updated Aug 7, 2026
Get this skill

Free · Opens the source repo

What List Projects does

The List Projects skill for Mem0 allows users to efficiently retrieve and display all project scopes associated with their stored memories. This skill is particularly useful for individuals who need to manage multiple projects and want to keep track of their memory distribution across these projects. By providing a clear overview of each project, including memory counts and last activity dates, users can quickly assess the status of their projects and identify which ones require attention.

This skill operates by fetching the user's memories through two distinct queries: one for memories without an associated application ID and another for those with an application ID. By merging the results of these queries, the skill creates a comprehensive list of projects. Each project is then analyzed to extract relevant information, such as the total number of memories, the most recent activity date, and the most common types of metadata associated with the memories. This structured approach ensures that users receive accurate and actionable insights into their projects.

The output is presented in a straightforward format, listing each project alongside its memory count and last activity date. This makes it easy for users to identify the most active projects at a glance. In cases where no projects are found, the skill provides a clear message prompting users to onboard and start creating memories. Overall, this skill is designed for users who need a reliable way to monitor their projects and manage their memories effectively.

When to use it

Use this skill when you need to check the status of your projects, compare memory counts, or locate specific project scopes.

When not to use it

This skill is not suitable for users who do not have any stored memories or those looking for advanced project management features beyond listing.

What you can build with it

Checking Project Status

Quickly assess the status of all your projects by viewing memory counts and last activity dates.

Comparing Memory Distribution

Easily compare how memories are distributed across different projects to identify areas needing attention.

Finding Specific Projects

Locate specific project scopes by reviewing the list of all known projects and their associated memories.

How to install List Projects

View source

1. Install with the skills CLI

npx skills add mem0ai/mem0/list-projects --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by mem0ai

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.

Frequently asked questions about List Projects

Similar skills