Solutions for common MemoryGraph issues.

Quick Diagnostics

# Check installation
which memorygraph
memorygraph --version

# Run health check
memorygraph --health

# Show configuration
memorygraph --show-config

# Check MCP status (Claude Code)
claude mcp list

Common Issues

Command not found: memorygraph

The memorygraph binary isn't in your PATH.

# If using pipx, ensure PATH is set
pipx ensurepath
# Restart your terminal

# Check where it's installed
python3 -c "import shutil; print(shutil.which('memorygraph') or 'Not in PATH')"

# Add to PATH manually (bash)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Add to PATH manually (zsh)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

MCP Server Connection Failed

Claude Code shows "Failed to connect" for memorygraph.

# Test the MCP server manually
echo '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}},"id":1}' | memorygraph

# Should return a JSON response with capabilities

# If it fails, check Python version
python3 --version  # Must be 3.10+

# Remove and re-add the server
claude mcp remove memorygraph
claude mcp add memorygraph memorygraph

Health Check Fails

# Run health check with verbose output
memorygraph --health

# Common failures:

# Timeout - backend not responding
# Solution: Check if backend is running, increase timeout
memorygraph --health --health-timeout 10.0

# Database locked (SQLite)
# Solution: Close other connections
lsof ~/.local/share/memorygraph/*.db

# Connection refused
# Solution: Verify backend credentials

Python Version Error

MemoryGraph requires Python 3.10 or higher.

# Check Python version
python3 --version

# On macOS, install with Homebrew
brew install python@3.11

# On Ubuntu/Debian
sudo apt update
sudo apt install python3.11

# Reinstall memorygraph with correct Python
pipx uninstall memorygraphMCP
pipx install memorygraphMCP --python python3.11

Permission Denied Errors

# Data directory permission issue
ls -la ~/.local/share/memorygraph/

# Fix permissions
chmod 755 ~/.local/share/memorygraph/
chmod 644 ~/.local/share/memorygraph/*.db

# Or use custom data directory
export MEMORYGRAPH_DATA_DIR=/path/with/permissions

Debug Mode

Enable verbose logging for troubleshooting:

# Set log level to DEBUG
export MEMORYGRAPH_LOG_LEVEL=DEBUG
memorygraph --health

# Or when adding to Claude Code
claude mcp add memorygraph memorygraph --env MEMORYGRAPH_LOG_LEVEL=DEBUG

Reset Configuration

Start fresh if things are broken:

# Remove MCP server config
claude mcp remove memorygraph

# Uninstall and reinstall
pipx uninstall memorygraphMCP
pipx install memorygraphMCP

# Re-add to Claude Code
claude mcp add memorygraph memorygraph

# Restart Claude Code
exit
claude

Getting Help