nwron-mcp

NWron memory over stdio MCP — persistent, project-scoped memory for coding agents (Claude Code, Codex, OpenCode, Cursor, Pi, …).

Local-first: the server extracts entities and embeds facts/queries on your machine with your own Voyage key (voyage-4-lite, 512d) before calling the NWron API. The cloud worker is a pure store — it never sees a provider key and never extracts anything. Without VOYAGE_API_KEY the tools still work, keyword-only.

Quick start

npx -y nwron-mcp

MCP client config (stdio):

{
  "mcpServers": {
    "nwron": {
      "command": "npx",
      "args": ["-y", "nwron-mcp"],
      "env": {
        "NWRON_API_URL": "https://nwron-api.4ims0mnia.workers.dev/api",
        "NWRON_API_KEY": "<your PERSONAL_API_KEY>",
        "VOYAGE_API_KEY": "<your Voyage key — optional, enables semantic search>"
      }
    }
  }
}

Codex (~/.codex/config.toml):

[mcp_servers.nwron]
command = "npx"
args = ["-y", "nwron-mcp"]
env = { NWRON_API_URL = "https://nwron-api.4ims0mnia.workers.dev/api", NWRON_API_KEY = "…", VOYAGE_API_KEY = "…" }

Prefer fully offline? npm i -g nwron-mcp once, then use "command": "nwron-mcp".

Project scope

Every tool accepts a project argument. Otherwise the server resolves a repo-root .nwron file (walking up from the cwd), then NWRON_PROJECT_ID — the same convention the NWron hooks use.

Tools (15)

| Area | Tools | |---|---| | read | remember, recent, context, memory, projects, project, activity, stats | | write | memorize, update_memory, forget | | graph | link_memory, unlink_memory | | maintain | consolidate (dry-run by default), project_create |

• remember — hybrid (vector + keyword) search; call first on any non-trivial task.
• context — one-call session-start block (durable + recent memories).
• memorize — store a fact/decision; embedded locally before saving.
• update_memory — edits are re-embedded locally when VOYAGE_API_KEY is set.

Environment

| Var | Required | Purpose | |---|---|---| | NWRON_API_URL | no | API base (default https://nwron-api.4ims0mnia.workers.dev/api) | | NWRON_API_KEY | no | PERSONAL_API_KEY bearer token (omit when the API is open, e.g. local dev) | | NWRON_PROJECT_ID | no | fallback project scope when no .nwron file exists | | VOYAGE_API_KEY | no | local embeddings (semantic search/capture); keyword-only without it |

License

MIT