Skip to content
MCP server

server-noonien

Peer-to-peer, conflict-free knowledge-graph memory MCP server for multiple machines

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, Linux
Runs
Locally
Version
1.3.0
Listing updated
2 days ago

About server-noonien

server-noonien is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

The official memory server keeps its knowledge graph in one JSONL file, which breaks when several machines share it. server-noonien keeps the same entities, observations and relations but gives every machine its own append-only shard and merges them as a CRDT (an LWW-Element-Set), so two machines that have seen the same operations hold identical graphs.

It installs as one npm package with three commands: the stdio MCP server, a maintenance CLI called noonien, and a replication daemon called nooniend. The daemon copies shards directly between machines over a VPN or LAN, so no shared folder or central service is needed. File and S3-compatible backends also work if you prefer a folder or bucket. Each node keeps a full local replica and works offline, and the README says the graph reconverges when the network returns.

The README describes it as a drop-in for the official server's nine tools, with extra update tools, merge_entities and read_conflicts. It needs Node.js 22 or later, is licensed MPL-2.0 and can import an existing memory.jsonl.

Install

Run in a terminal

claude mcp add server-noonien -- npx -y server-noonien

Add to claude_desktop_config.json

{
  "mcpServers": {
    "server-noonien": {
      "command": "npx",
      "args": [
        "-y",
        "server-noonien"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "server-noonien": {
      "command": "npx",
      "args": [
        "-y",
        "server-noonien"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "server-noonien": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "server-noonien"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "server-noonien": {
      "command": "npx",
      "args": [
        "-y",
        "server-noonien"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "server-noonien": {
      "command": "npx",
      "args": [
        "-y",
        "server-noonien"
      ]
    }
  }
}

Configuration

  • NOONIEN_DIRDirectory holding this machine's shards (default ~/.noonien).
  • NOONIEN_NODE_IDThis node's shard name (default the hostname). Must be unique per machine.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

merge_entities
Extension tool for merging entities in the graph.
read_conflicts
Extension tool for reading conflicting entries.

What it does

Per-node shards
Each machine writes only its own append-only shard, so files never conflict.
CRDT merge
Shards merge deterministically instead of last write winning.
Peer-to-peer sync
The nooniend daemon replicates shards between machines without a server.
File and S3 backends
Shared folders or S3-compatible buckets are optional transports.
Drop-in tools
Keeps the official memory server's tool surface and adds extensions.
Offline-first
Every node reads and writes locally and syncs when reachable.

Good for

  • Share one agent memory across a laptop and a desktop
  • Replace the official memory server without changing agent prompts
  • Keep memory on your own machines instead of a hosted service
  • Migrate an existing memory.jsonl into a mergeable store

Pricing

Open source

MPL-2.0 licence per the README

server-noonien FAQ

Does it need a server or database?

No. The README says it needs no central server, database or cloud account.

What does it need to run?

Node.js 22 or later; install with npm install -g server-noonien.

What licence is it under?

MPL-2.0, according to the README comparison table.

How do I move my existing memory?

The README gives the command noonien import memory.jsonl.

Is server-noonien free?

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

How do I add server-noonien to Claude Code?

Run this command in your terminal: claude mcp add server-noonien -- npx -y server-noonien

What are the best alternatives to server-noonien?

The closest alternatives to server-noonien are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

Alternatives to server-noonien

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  5. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity