# NeuroStack

NeuroStack indexes Markdown notes for MCP search, link traversal, and session memories. Use it to give an AI client access to an existing notes vault.

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

## What it does

NeuroStack builds a SQLite index from `.md` files, combining text search, embeddings, and a graph of wiki links. An MCP client can retrieve ranked evidence with note paths, while the AI handles the reasoning. Indexing leaves the Markdown files unchanged.

The server can flag notes that have gone stale and turn decisions from AI sessions into saved memories. For Claude Code, connect through the hosted HTTP endpoint or run the package locally with `npx` and `NEUROSTACK_VAULT_ROOT`. These are separate connection options; choose one configuration method.

Lite offers keyword search and link-based connections without GPU or Ollama. Full adds semantic search, generated summaries, and topic grouping through Ollama. The project recommends a GPU or a CPU with 6+ cores for Full.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.neurostack.sh/mcp`
- Environment variables: `NEUROSTACK_VAULT_ROOT` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http neurostack https://mcp.neurostack.sh/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env NEUROSTACK_VAULT_ROOT=<NEUROSTACK_VAULT_ROOT> --transport stdio neurostack -- npx -y neurostack
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add neurostack --url https://mcp.neurostack.sh/mcp
```

2. **Platform CLI**
```bash
codex mcp add neurostack --env NEUROSTACK_VAULT_ROOT=<NEUROSTACK_VAULT_ROOT> -- npx -y neurostack
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "neurostack": {
            "url": "https://mcp.neurostack.sh/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "neurostack": {
            "command": "npx",
            "args": [
                "-y",
                "neurostack"
            ],
            "env": {
                "NEUROSTACK_VAULT_ROOT": "<NEUROSTACK_VAULT_ROOT>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "neurostack": {
            "type": "http",
            "url": "https://mcp.neurostack.sh/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "neurostack": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "neurostack"
            ],
            "env": {
                "NEUROSTACK_VAULT_ROOT": "<NEUROSTACK_VAULT_ROOT>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http neurostack https://mcp.neurostack.sh/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e NEUROSTACK_VAULT_ROOT=<NEUROSTACK_VAULT_ROOT> neurostack npx -y neurostack
```
Replace <…> with your own values

## When to use it
- search a Markdown vault for project context
- follow wiki-link connections between notes
- spot notes that may have become stale
- save session decisions as AI memories

## Example prompts
- Search my notes for decisions about the project architecture.
- Check the vault for notes that may be out of date.
- Save the decisions and root causes from this session as memories.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433

---
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