New to Claude Skills? Learn how to install them →

Get Claude Skills
Mmem0ai on GitHub

Mem0 Health Check

Free

Diagnose Mem0 connectivity and functionality issues.

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

Free · Opens the source repo

What Mem0 Health Check does

The Mem0 Health Check skill is designed for developers and designers who rely on the Mem0 plugin for memory operations. This skill runs a series of diagnostic checks to ensure that the plugin is functioning correctly. It checks the validity of the API key, verifies identity resolution, tests connectivity, and assesses memory write capabilities. By executing all checks in one go, users can quickly identify any issues without stopping at the first failure, streamlining the troubleshooting process.

When you run the health check, it will verify if the API key is configured properly, report the resolved identity, and test connectivity by performing a health check query. Additionally, it checks the memory write capability by attempting to add and delete a test entry. If any of these checks fail, the skill provides specific troubleshooting steps to help resolve the issues, making it an essential tool for maintaining the reliability of the Mem0 plugin.

For users who need a deeper analysis, the skill also supports an extended mode that performs a memory quality analysis. This includes checks for duplicate memories, stale memories, and contradictions within the stored data. The results of these checks can help users maintain a clean and efficient memory system, ensuring that the data they rely on is accurate and up-to-date.

Overall, the Mem0 Health Check skill is a valuable resource for anyone working with the Mem0 plugin, providing essential diagnostics and insights into memory management.

When to use it

Use this skill when experiencing failures in memory operations, such as empty search results or when verifying that the Mem0 plugin is set up correctly.

When not to use it

This skill is not suitable for general memory management tasks or when the Mem0 plugin is functioning as expected.

What you can build with it

Troubleshooting Memory Operations

When memory operations fail or return empty results, use this skill to diagnose and fix the issues.

Verifying Plugin Setup

Before starting a project, run the health check to ensure the Mem0 plugin is correctly configured.

Maintaining Memory Quality

Use the extended mode to analyze memory quality and identify duplicates or stale entries.

How to install Mem0 Health Check

View source

1. Install with the skills CLI

npx skills add mem0ai/mem0/status --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

Health Check / Status

Run a diagnostic check on the Mem0 plugin. Useful for troubleshooting.

Execution

Run ALL checks, then display a single summary. Do not stop on the first failure.

Check 1: API key

Verify the API key is configured. The plugin loads it from MEM0_API_KEY env var or ~/.pi/agent/mem0-config.json.

  • If not set: FAIL — "No API key configured"
  • If set: PASS — show first 6 chars followed by ...

Check 2: Identity resolution

Report the resolved identity:

  • user_id: from config, env, or system user
  • project_id: auto-detected from current directory
  • session_id: current session identifier

PASS if user_id and project_id are non-empty. WARN if any falls back to defaults.

Check 3: Connectivity

Use mem0_memory tool with action="search", query="health check".

  • If returns successfully (even empty): PASS
  • If errors: FAIL — show the error message

Check 4: Memory write capability

Use mem0_memory tool with action="add", content="Health check probe — safe to delete.".

  • If succeeds: PASS — then clean up by deleting the probe memory.
  • If errors: FAIL — show the error.

Display

## mem0 health

PASS  API Key          m0-dVe...
PASS  Identity         user=kartik, project=my-app, session=abc123
PASS  Connectivity     142ms
PASS  Write/Read       write + delete OK

All checks passed.

If any check fails, add a ## Troubleshooting section with specific fix steps.

Extended mode: Memory Quality Analysis

When invoked with --deep (e.g., /mem0-status --deep), run the standard checks above plus a memory quality scan.

Quality Check 1: Duplicates

Fetch all memories with mem0_memory action="get_all". Compare pairs within the same category for high textual overlap (shared nouns > 60%). Report:

Potential duplicates: <N> pairs
  [mem0:<id1>] ~ [mem0:<id2>] — both about "<shared topic>"

Quality Check 2: Stale memories

Flag memories older than 180 days that haven't been accessed recently.

Quality Check 3: Contradictions

Within each category, flag pairs that assert opposing facts.

Quality summary

## Memory Quality

Duplicates: <N> · Stale: <N> · Contradictions: <N>

If all counts are 0: Memory quality: clean. If any non-zero: append Run /mem0-dream to fix.

Frequently asked questions about Mem0 Health Check

Similar skills

Spring Boot Testing

Master testing techniques for Spring Boot 4 applications.

GitHub Issues

Manage GitHub issues efficiently with MCP tools.

Geofeed Tuner

Optimize your IP geolocation feeds in CSV format.

Batch Files

Master Windows batch scripting for automation and task management.

Adobe Illustrator Scripting

Automate your Illustrator workflows with ExtendScript.

Plugin Structure

Create and organize Claude Code plugins effectively.