nanomem MCP Server

by ombansod2io.github.OmBansod2/nanomemv0.8.3

Memory that knows when a remembered fact has been replaced, not just when it was written.

1Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active17d ago

Install nanomem MCP server

claude mcp add nanomem -e NANOMEM_PASSWORD='<nanomem-password>' -- uvx nanomem

{
  "mcpServers": {
    "nanomem": {
      "command": "uvx",
      "args": [
        "nanomem"
      ],
      "env": {
        "NANOMEM_PASSWORD": "<nanomem-password>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "nanomem": {
      "command": "uvx",
      "args": [
        "nanomem"
      ],
      "env": {
        "NANOMEM_PASSWORD": "<nanomem-password>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "nanomem": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "nanomem"
      ],
      "env": {
        "NANOMEM_PASSWORD": "<nanomem-password>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "nanomem": {
      "command": "uvx",
      "args": [
        "nanomem"
      ],
      "env": {
        "NANOMEM_PASSWORD": "<nanomem-password>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
NANOMEM_VAULT	—	—	Path to the memory vault file. Defaults to ~/.nanomem/memory.dat.
NANOMEM_PASSWORD	—	yes	Passphrase to encrypt the vault at rest. Leave UNSET for a plaintext vault; setting it to an empty string is refused rather than silently producing one.

Freshness

Active — last maintenance signal 17d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-23 · 17d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-09-23 · 17d ago · official registry · v0.8.3

FAQ

›How do I install the nanomem MCP server in Claude Code?

Run: claude mcp add nanomem -e NANOMEM_PASSWORD='<nanomem-password>' -- uvx nanomem. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does nanomem require an API key?

Yes. It expects NANOMEM_PASSWORD, of which 1 is a secret.

›Can I use nanomem as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is nanomem in the official MCP registry?

Yes, as io.github.OmBansod2/nanomem.