Nuzo Memory

Official

by fabionfsc · TypeScript

Local-first, auditable memory for MCP-compatible AI agents with explicit writes and SQLite storage.

io.github.fabionfsc/nuzo-memory MCP Server

Local-first, auditable memory for MCP-compatible AI agents with explicit writes and SQLite storage.

slug: io-github-fabionfsc-nuzo-memory
name: io.github.fabionfsc/nuzo-memory
description: Local-first, auditable memory for MCP-compatible AI agents with explicit writes and SQLite storage.
topics: ai-agents, claude-code, codex, developer-tools, local-first, mcp, memory, sqlite
readmeExcerpt: # @nuzo/mcp-server … Documentation: https://nuzo.com.br/ … This package remains available for existing users and automation, but every published ver

🛠️ Key Features

Local-first memory layer designed for MCP-compatible AI agents
Explicit write model with auditable history
SQLite storage backend for persistence
Compatibility with the Nuzo MCP server ecosystem
Supports shared runtime environment variables (NUZO_MEMORY_STORE, NUZO_MEMORY_SCOPE, NUZO_AUTHORIZED_SCOPES)

🚀 Use Cases

Auditable memory for autonomous agents in development and testing
Local data persistence for MCP-based workflows
Legacy MCP server compatibility with a unified memory package
Reproducible installs via pinned host artifacts

⚡ Developer Benefits

Clear groundings to MCP protocol and Nuzo runtime hooks
Easy migration path via unified memory package
Documentation references and reproducible install commands
Maintains support for existing automation and ecosystems

⚠️ Limitations

Legacy MCP server package; recommended transition to unified package for new projects
ReadmeExcerpt notes ongoing compatibility considerations and required runtime environment variables

Topics

ai-agentsclaude-codecodexdeveloper-toolslocal-firstmcpmemorysqlite

packages/mcp-server/README.md1 KBView on GitHub

@nuzo/mcp-server

Legacy transition Nuzo MCP server package.

Use the unified package instead:

bash

npm exec --yes --package=@nuzo/memory -- nuzo-mcp-server

Generated host plugin artifacts pin @nuzo/memory for reproducible installs.

bash

npm exec --yes --package=@nuzo/memory -- nuzo-memory-hook --doctor

The MCP server and hook runner honor the shared Nuzo runtime environment: NUZO_MEMORY_STORE, NUZO_MEMORY_SCOPE, and NUZO_AUTHORIZED_SCOPES.

Documentation: https://nuzo.com.br/

This package remains available for existing users and automation, but every published version is deprecated with migration guidance to @nuzo/memory. New installs should use @nuzo/memory.

License: Apache-2.0

Install

Configuration

Environment variables

NUZO_MEMORY_STORE

Optional absolute path to the local SQLite memory store.

NUZO_MEMORY_SCOPE

Optional default Nuzo memory scope, such as user:default or project:auto.

NUZO_AUTHORIZED_SCOPES

Optional comma-separated allowlist of memory scopes available to this MCP process.

NUZO_PROJECT_ROOT

Optional project root used to resolve project:auto scope.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "nuzo-memory": {
      "command": "npx",
      "args": [
        "-y",
        "@nuzo/memory-mcp@1.1.0"
      ],
      "env": {
        "NUZO_MEMORY_STORE": "<YOUR_NUZO_MEMORY_STORE>",
        "NUZO_MEMORY_SCOPE": "<YOUR_NUZO_MEMORY_SCOPE>",
        "NUZO_AUTHORIZED_SCOPES": "<YOUR_NUZO_AUTHORIZED_SCOPES>",
        "NUZO_PROJECT_ROOT": "<YOUR_NUZO_PROJECT_ROOT>"
      }
    }
  }
}

Nuzo Memory - agentage MCP Catalog