Skip to content
MCP server

nanomem

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.8.3
Listing updated
5 days ago

About nanomem

nanomem is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add nanomem --env NANOMEM_PASSWORD='<NANOMEM_PASSWORD>' -- uvx nanomem

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • NANOMEM_VAULTPath to the memory vault file. Defaults to ~/.nanomem/memory.dat.
  • NANOMEM_PASSWORDPassphrase 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.

Pricing

Open source

nanomem FAQ

Is nanomem free?

Yes. nanomem is open source, so you can use and self-host it for free.

How do I add nanomem to Claude Code?

Run this command in your terminal: claude mcp add nanomem --env NANOMEM_PASSWORD='<NANOMEM_PASSWORD>' -- uvx nanomem

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers