Albert can now connect to your own kaeru memory over MCP. Keep memory embedded
as before, or let a separate kaeru server hold it while Albert recalls, learns and
reflects through the same memory tools.
Bring your own memory
- HTTP or stdio. Connect to a kaeru MCP endpoint over Streamable HTTP, or use
the localkaeru-mcp --stdiobridge. - Token authentication. A protected endpoint takes a bearer token from an
environment variable; the config stores only its name. - Ready on first startup. If the connected memory has no
albertinitiative,
Albert creates it through an ordinary memory record. Later starts leave an
existing initiative unchanged. - One memory interface. Recall, capture and automatic reflection use the
selected backend. MCP memory is a dedicated connection, separate from the
world-facing connector catalog.
Connection failures stay visible
- Connection and tool calls have time limits. A disconnected session is
re-established on the next call. - A failed write is not automatically replayed: it may already have reached the
server. Albert does not silently switch to an empty local memory when MCP fails.
Upgrading from v0.2.0
Embedded memory remains the default. To use a kaeru MCP server:
[memory]
backend = "mcp"
transport = "http"
url = "http://127.0.0.1:9876/mcp"
token_env = "ALBERT_MEMORY_TOKEN" # omit for an endpoint without authentication
timeout_secs = 30Set ALBERT_MEMORY_TOKEN in the environment or .env to match the server's token,
then restart Albert. Use HTTPS for a remote endpoint. Switching backends does not
copy existing memories; configure cloud endpoints on the MCP server when using
external memory.
Use kaeru-mcp 0.7.4 or later. If you maintain a custom system.md, update the
old tool names: kaeru_remember → kaeru_episode, kaeru_read → kaeru_at,
kaeru_test → kaeru_evidence, and follow their current argument schemas.
Full configuration, including stdio:
memory backend.
Built on Octo v0.2.0, kaeru v0.7.4 and rig 0.35.
Early and in active testing — feedback and issues are very welcome.
Binary
albert-v0.2.1-x86_64-linux-gnu — a release build for x86_64 Linux with glibc 2.39
or newer (e.g. Ubuntu 24.04). It links the system libcurl.so.4, OpenSSL 3 and
libstdc++. Long recordings and videos also need ffmpeg. Deployment:
docs/deploy.md.
SHA-256:
330adbd2955a03be5559cc298b00e34497b74f6f0a917161eef6cbe9056ba839 albert-v0.2.1-x86_64-linux-gnu
Verify: sha256sum -c albert-v0.2.1-x86_64-linux-gnu.sha256