# engram-mcp — plug your Engram brain into any Claude Code / Desktop

Client pieces for an [Engram](https://brain.khosha.tech) brain: a stdio **MCP server** (tools
`search_brain`, `get_concept`, `list_concepts`, `add_memory`) and the **`/engram-capture`** skill
(push a whole conversation into the brain). No secrets in this repo — you supply your brain URL +
token at setup. Works on macOS/Linux with Node 18+.

## Install (per machine — repeat on each Mac)

```bash
git clone https://github.com/ankitjm/engram-mcp.git ~/engram-mcp
cd ~/engram-mcp && npm install

# 1) Register the MCP with Claude Code (tools appear in every session)
claude mcp add engram --scope user \
  --env ENGRAM_URL=https://brain.khosha.tech \
  --env ENGRAM_API_TOKEN=engr_YOUR_TOKEN \
  -- node ~/engram-mcp/mcp.js

# 2) (Optional) the /engram-capture skill
mkdir -p ~/.claude/skills && cp -r ~/engram-mcp/engram-capture ~/.claude/skills/
mkdir -p ~/.engram && cp ~/engram-mcp/config.example.json ~/.engram/config.json
# then edit ~/.engram/config.json: set token + password_sha256
#   node -e "console.log(require('crypto').createHash('sha256').update('YOUR_PASS').digest('hex'))"
```

Restart Claude Code. Every machine pointed at the same `ENGRAM_URL` + token shares one brain.