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.