health

Diagnoses mem0 plugin connectivity, API key validity, and memory read/write functionality.

Updated Jun 29, 2026
One-click install
npx skills add https://github.com/nhatnguyen1122/Agent-Memory-Eval --skill health-nhatnguyen1122
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: health
Source: https://github.com/nhatnguyen1122/Agent-Memory-Eval/tree/main/mem0/integrations/mem0-plugin/skills/health
Command: npx skills add https://github.com/nhatnguyen1122/Agent-Memory-Eval --skill health-nhatnguyen1122

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When memory operations fail, searches return empty results, or the MCP connection drops, it is hard to tell whether the cause is a missing API key, broken identity resolution, or a server-side issue. This Skill runs a structured diagnostic to pinpoint the failure. ## Core Features & Use Cases - Five-Point Diagnostic: Checks API key configuration, identity resolution (user/project/branch), MCP server connectivity, memory write/read capability, and the session stats tracker in one pass. - Memory Quality Scan: With the --deep flag, detects duplicate, stale, low-confidence, contradictory, and untagged memories across your stored data. - Use Case: Your add_memory calls suddenly error out mid-session. Run the health check to see a PASS/FAIL summary for each component, plus targeted troubleshooting steps for whatever failed. ## Quick Start Ask the assistant to run the mem0 health check to diagnose why memory operations are failing.

Frequently Asked Questions about health

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot mem0 memory operations that are failing?

Run the health check, which executes five diagnostics: API key presence, identity resolution, MCP connectivity, write/read capability, and session stats. It reports PASS or FAIL per check with specific troubleshooting steps for any failure.

How to check if my mem0 API key is configured correctly?

The health check reads MEM0_API_KEY or CLAUDE_PLUGIN_OPTION_MEM0_API_KEY and prints only the first six characters for verification. If neither variable is set, it reports NOT_SET and flags the check as failed.

Why does mem0 search return empty results?

Empty results often stem from wrong user_id or project_id filters, an invalid API key, or a dropped MCP connection. The health check verifies identity resolution and tests search_memories connectivity to isolate the cause.

Can I detect duplicate or stale memories in mem0?

Yes, run the health check with the --deep flag to scan for duplicates, stale entries, low-confidence memories, contradictions, and untagged orphans. It summarizes counts per category and suggests running the dream skill to fix issues.

What happens if the mem0 session stats file is missing?

The stats file at /tmp/mem0_session_stats_$USER.json is created by the SessionStart hook. If missing, the session hooks may not have fired yet; send a message first, then recheck.