Empirical Docs / MCP

Claude Code integration.

Connect Claude Code to Empirical MCP using CLI install flow and verify tool-level memory operations.

Install path

Two ways in — pick whichever fits how you're already working. Either way, finish with `empirical install`: that's what registers Empirical MCP, wires up OAuth, and unlocks CLI-only features (hooks, skill sync) that installing the plugin alone doesn't set up.

# Option A: npm, straight from a terminal
npm install -g @empirical-gauzza/cli
empirical install

# Option B: from inside Claude Code, via the plugin marketplace
/plugin marketplace add mattgauzza/empirical-memory-plugin
/plugin install empirical-memory@empirical-memory
npm install -g @empirical-gauzza/cli
empirical install

OAuth auth

If session expires, reconnect from Claude MCP settings and retry failed call once.

Verify tools

Confirm query_memories and record_graph_memory complete without auth errors.

Last updated: Aug 27, 2026