# shodh-memory

Equips your agent with three-tier cognitive memory, vector semantic search, and a built-in GTD task manager.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 316
- Author: varun29ankuS
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/varun29ankuS/shodh-memory/tree/HEAD/mcp-server
- Updated: 2026-10-19
- HTML: https://affpapa.org/en/nevibecode/mcp/shodh-memory

## What it does

The server organizes memory across working, session, and long-term stores following Cowan's cognitive framework. Vector lookups rely on MiniLM-L6 embeddings, while an internal knowledge graph tracks entities and strengthens frequent associations via Hebbian learning. Identical items are dropped automatically by checking content hashes.

Requests travel over standard HTTP by default, though you can route traffic through a Unix domain socket or a Windows named pipe via `SHODH_IPC_ENDPOINT`. The initial launch fetches roughly 38MB of dependencies, which include the native engine and embedding assets. Without a configured `SHODH_API_KEY`, the server refuses to run.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `SHODH_API_URL`, `SHODH_API_KEY`, `SHODH_USER_ID` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env SHODH_API_URL=<SHODH_API_URL> --env SHODH_API_KEY=<SHODH_API_KEY> --env SHODH_USER_ID=<SHODH_USER_ID> --transport stdio mcp-server -- npx -y @shodh/memory-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mcp-server --env SHODH_API_URL=<SHODH_API_URL> --env SHODH_API_KEY=<SHODH_API_KEY> --env SHODH_USER_ID=<SHODH_USER_ID> -- npx -y @shodh/memory-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@shodh/memory-mcp"
            ],
            "env": {
                "SHODH_API_URL": "<SHODH_API_URL>",
                "SHODH_API_KEY": "<SHODH_API_KEY>",
                "SHODH_USER_ID": "<SHODH_USER_ID>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@shodh/memory-mcp"
            ],
            "env": {
                "SHODH_API_URL": "<SHODH_API_URL>",
                "SHODH_API_KEY": "<SHODH_API_KEY>",
                "SHODH_USER_ID": "<SHODH_USER_ID>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e SHODH_API_URL=<SHODH_API_URL> -e SHODH_API_KEY=<SHODH_API_KEY> -e SHODH_USER_ID=<SHODH_USER_ID> mcp-server npx -y @shodh/memory-mcp
```
Replace <…> with your own values

## When to use it
- retain context and technical decisions across separate agent sessions
- retrieve relevant project notes by meaning using vector embeddings
- track project tasks, subtasks, and reminders within GTD workflows
- prevent duplicate memories using automatic content-hash filtering

## Example prompts
- Recall our earlier architectural decisions regarding the database schema.
- Save this code style preference into long-term memory with a styling tag.
- List all open tasks associated with the current refactoring milestone.

## Similar
- [agentdb-query](https://affpapa.org/en/nevibecode/skills/agentdb-query.md) — skill · 745 installs
- [openviking-memory](https://affpapa.org/en/nevibecode/skills/openviking-memory.md) — skill · 504 installs
- [codeseeker](https://affpapa.org/en/nevibecode/mcp/codeseeker.md) — MCP server · ★ 20
- [para-memory-files](https://affpapa.org/en/nevibecode/skills/para-memory-files.md) — skill · 1800 installs
- [memory-continue](https://affpapa.org/en/nevibecode/skills/memory-continue.md) — skill · 1300 installs
- [Reverie](https://affpapa.org/en/nevibecode/mcp/reverie.md) — MCP server · ★ 69

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md