Token-saving persistent memory for AI agents: recall durable facts instead of re-reading files.
Connect Runs on your machine
claude mcp add builderforce-memory -e BUILDERFORCE_MEMORY_FILE=<BUILDERFORCE_MEMORY_FILE> -e BUILDERFORCE_MEMORY_READONLY=<BUILDERFORCE_MEMORY_READONLY> -e BUILDERFORCE_API_KEY=<BUILDERFORCE_API_KEY> -- npx -y @seanhogg/[email protected]
{
"mcpServers": {
"builderforce-memory": {
"command": "npx",
"args": [
"-y",
"@seanhogg/[email protected]"
],
"env": {
"BUILDERFORCE_MEMORY_FILE": "<BUILDERFORCE_MEMORY_FILE>",
"BUILDERFORCE_MEMORY_READONLY": "<BUILDERFORCE_MEMORY_READONLY>",
"BUILDERFORCE_API_KEY": "<BUILDERFORCE_API_KEY>"
}
}
}
}
{
"mcpServers": {
"builderforce-memory": {
"command": "npx",
"args": [
"-y",
"@seanhogg/[email protected]"
],
"env": {
"BUILDERFORCE_MEMORY_FILE": "<BUILDERFORCE_MEMORY_FILE>",
"BUILDERFORCE_MEMORY_READONLY": "<BUILDERFORCE_MEMORY_READONLY>",
"BUILDERFORCE_API_KEY": "<BUILDERFORCE_API_KEY>"
}
}
}
}
{
"servers": {
"builderforce-memory": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@seanhogg/[email protected]"
],
"env": {
"BUILDERFORCE_MEMORY_FILE": "<BUILDERFORCE_MEMORY_FILE>",
"BUILDERFORCE_MEMORY_READONLY": "<BUILDERFORCE_MEMORY_READONLY>",
"BUILDERFORCE_API_KEY": "<BUILDERFORCE_API_KEY>"
}
}
}
}
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
BUILDERFORCE_MEMORY_FILEOptional | Absolute path to the JSON snapshot that makes memory survive restarts. Defaults to ~/.builderforce-memory/memory.json, which every MCP host on the machine shares. |
BUILDERFORCE_MEMORY_READONLYOptional | Set to 1 to expose recall only (disables memory_remember and memory_forget). |
BUILDERFORCE_API_KEYOptional, secret | Builderforce tenant API key (bfk_*). When set, additionally exposes the token_usage and model_efficiency cost tools. |
Details
| Package | @seanhogg/[email protected] (NPM, stdio) |
| First published | 10 Nov 2026 |
| Last updated | 10 Nov 2026 |
| Registry name | io.github.SeanHogg/builderforce-memory |
More ai and media servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
