Delx Memory
by davidmosiahcommunityv0.2.1
An MCP server that exposes a shared local SQLite-backed key/value memory store so multiple MCP clients can read and write the same persistent context across sessions. It includes read/search tools, tagged and TTL-based memory, and blocks storing credential-like secrets.
From the registry: Local-first persistent memory MCP: shared SQLite key/value store, searchable, TTL-aware, secret-safe
Install & configure
Prerequisites
- requiredInstall Node.js 20 or newerNode.js version 20 or higher is required to run the server via npx or as a global npm package.
- optionalRun the health checkRun the server's doctor command once to verify Node version, database writability, and file permissions before configuring your MCP client.
$ npx -y delx-memory doctor
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `delx-memory` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Node.js 20 or newer** — Node.js version 20 or higher is required to run the server via npx or as a global npm package.
Optional prerequisites:
- Run the health check — Run the server's doctor command once to verify Node version, database writability, and file permissions before configuring your MCP client. Run: `npx -y delx-memory doctor`
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","delx-memory"]
- optional environment variables:
- `DELX_MEMORY_PATH`: Override the SQLite database file path used for persistent memory storage. (example: `<your-db-file-path>`)
- `DELX_MEMORY_TRANSPORT`: Transport mode. Defaults to stdio; set only if you need to override transport selection. (example: `<stdio-or-http>`)
- `DELX_MEMORY_HOST`: HTTP host to bind when running in HTTP mode. (example: `<your-http-host>`)
- `DELX_MEMORY_PORT`: HTTP port to bind when running in HTTP mode. (example: `<your-http-port>`)
- `DELX_MEMORY_ALLOWED_ORIGIN`: Allowed CORS origin when running in HTTP mode. (example: `<your-allowed-origin>`)
Note: The README presents stdio as the default MCP client configuration using `npx -y delx-memory`. The server also supports HTTP mode via `delx-memory --http` or environment overrides, but no canonical MCP client HTTP config snippet is provided. Default storage is at `~/.delx-memory/db.sqlite`.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: The README presents stdio as the default MCP client configuration using `npx -y delx-memory`. The server also supports HTTP mode via `delx-memory --http` or environment overrides, but no canonical MCP client HTTP config snippet is provided. Default storage is at `~/.delx-memory/db.sqlite`.
Tools (8)
memory_stats
Shows high-level database stats such as total keys, DB size, oldest entry, and DB path.
memory_list
Lists keys without values, optionally filtered by prefix or tag.
memory_get
Fetches the exact value for a key along with timestamps, tags, and metadata.
memory_search
Runs full-text search across keys, values, and tags with relevance ranking and snippets.
memory_set
Upserts a memory entry, rejecting credential-shaped keys or values.
memory_forget
Deletes a single key.
memory_forget_by_tag
Deletes all entries with a given tag.
memory_export
Exports the store as JSON, JSONL, or Markdown, optionally within a time window.
Environment variables
DELX_MEMORY_PATHOverrides the location of the SQLite database file.Packages
delx-memory
npmv0.2.1transport: stdio
Details
- Language
- TypeScript
- License
- MIT
- Released
- May 29, 2026
- Last commit
- Jun 2, 2026
- Registry name
- io.github.davidmosiah/delx-memory