# neuromcp MCP server

> Provides AI agents with a local, sovereign semantic memory layer using hybrid search, knowledge graphs, and a Markdown-based wiki.

- Repository: https://github.com/AdelElo13/neuromcp
- Page: https://hostedmcp.org/servers/adelelo13/neuromcp
- Transport: stdio
- Stars: 4
- Latest version: 0.30.2

## Install

### Claude Code

```sh
claude mcp add neuromcp -- npx -y neuromcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "neuromcp": {
      "command": "npx",
      "args": [
        "-y",
        "neuromcp"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "neuromcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "neuromcp"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"neuromcp","type":"stdio","command":"npx","args":["-y","neuromcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "neuromcp": {
      "command": "npx",
      "args": [
        "-y",
        "neuromcp"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add neuromcp -- npx -y neuromcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.neuromcp]
command = "npx"
args = ["-y", "neuromcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user neuromcp npx -- -y neuromcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "neuromcp": {
      "command": "npx",
      "args": [
        "-y",
        "neuromcp"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `NEUROMCP_DB_PATH` | no | no |  |
| `NEUROMCP_EMBEDDING_PROVIDER` | no | no |  |
| `NEUROMCP_NAMESPACE` | no | no |  |

## FAQ

### Does neuromcp require an API key or cloud subscription?

No, it is a sovereign memory layer that stores everything locally on your machine with no API keys or cloud sync required.

### How does the memory retrieval work?

It uses hybrid retrieval that combines vector search, BM25 full-text search, graph links, and a learned usefulness prior.

### Which AI clients are compatible with neuromcp?

It works with any MCP-compatible client including Claude Desktop, Cursor, Windsurf, Codex CLI, Continue, LibreChat, and Open WebUI.
