Xentropy Notes — Memory Layer for AI MCP Server

by xentropyaiio.github.xjpru/xentropy-notesv0.3.1

Semantic search and knowledge graph for your Wall notes from Claude Code and MCP clients.

Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Deprecated4mo ago

Install Xentropy Notes — Memory Layer for AI MCP server

claude mcp add xentropyai -e XEN_API_TOKEN='<xen-api-token>' -e XEN_REFRESH_TOKEN='<xen-refresh-token>' -- npx -y @xentropy/mcp

{
  "mcpServers": {
    "xentropyai": {
      "command": "npx",
      "args": [
        "-y",
        "@xentropy/mcp"
      ],
      "env": {
        "XEN_API_TOKEN": "<xen-api-token>",
        "XEN_REFRESH_TOKEN": "<xen-refresh-token>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "xentropyai": {
      "command": "npx",
      "args": [
        "-y",
        "@xentropy/mcp"
      ],
      "env": {
        "XEN_API_TOKEN": "<xen-api-token>",
        "XEN_REFRESH_TOKEN": "<xen-refresh-token>"
      }
    }
  }
}

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

{
  "servers": {
    "xentropyai": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@xentropy/mcp"
      ],
      "env": {
        "XEN_API_TOKEN": "<xen-api-token>",
        "XEN_REFRESH_TOKEN": "<xen-refresh-token>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "xentropyai": {
      "command": "npx",
      "args": [
        "-y",
        "@xentropy/mcp"
      ],
      "env": {
        "XEN_API_TOKEN": "<xen-api-token>",
        "XEN_REFRESH_TOKEN": "<xen-refresh-token>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
XEN_API_URL	—	—	Xentropy API base URL. Defaults to http://localhost:3001/api. Must include the /api prefix.
XEN_API_TOKEN	—	yes	API token (Supabase access JWT) for static authentication. Obtain via 'xen-notes-mcp login --email YOU --password X --show-token'.
XEN_REFRESH_TOKEN	—	yes	Refresh token for automatic token rotation. Only needed if using static token auth without interactive login.

Freshness

Deprecated — last maintenance signal 4mo ago. The newest of the signals below sets the band.

Last commit (default branch)
no data · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-06-24 · 4mo ago · official registry · v0.3.1

FAQ

›How do I install the Xentropy Notes — Memory Layer for AI MCP server in Claude Code?

Run: claude mcp add xentropyai -e XEN_API_TOKEN='<xen-api-token>' -e XEN_REFRESH_TOKEN='<xen-refresh-token>' -- npx -y @xentropy/mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Xentropy Notes — Memory Layer for AI require an API key?

Yes. It expects XEN_API_TOKEN, XEN_REFRESH_TOKEN, of which 2 are secrets.

›Can I use Xentropy Notes — Memory Layer for AI as a remote (hosted) MCP server?

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

›Is Xentropy Notes — Memory Layer for AI in the official MCP registry?

Yes, as io.github.xjpru/xentropy-notes.