Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@haksnbot-memory Search my memories for anything about Steve"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP (Model Context Protocol) server that provides persistent memory storage for AI agents. Uses SQLite with full-text search for efficient storage and retrieval of memories.
Part of the Haksnbot suite: This project was originally developed as part of Haksnbot, an autonomous Minecraft bot. The suite includes four repos that work together: haksnbot-tools (Minecraft bot control), haksnbot-mind (the autonomous agent), haksnbot-admin (server administration), and haksnbot-memory (this repo - persistent memory). Each can be used independently, but they're designed to work together.
Persistent storage - Memories survive agent restarts
Full-text search - Find memories by content using FTS5
Tagging system - Organize memories with flexible tags
Importance levels - Prioritize significant memories
Pagination - Handle large memory collections efficiently
Related MCP server: agent-memory-hub
git clone https://github.com/haksndot/haksnbot-memory.git
cd haksnbot-memory
npm installAdd to your Claude Code MCP settings (~/.claude/settings.json):
{
"mcpServers": {
"memory": {
"command": "node",
"args": ["/path/to/haksnbot-memory/src/index.js"]
}
}
}The database path can be set via environment variable:
{
"mcpServers": {
"memory": {
"command": "node",
"args": ["/path/to/haksnbot-memory/src/index.js"],
"env": {
"MEMORY_DB_PATH": "/path/to/memories.db"
}
}
}
}If not set, defaults to memories.db in the package directory.
Tool | Description |
| Store a new memory with optional tags, context, and importance |
| Retrieve a specific memory by ID |
| Update an existing memory's content, tags, or importance |
| Remove a memory |
| List memories with filtering, sorting, and pagination |
| Full-text search across memory content, tags, and context |
| Get statistics: total count, tag distribution, date range |
Each memory contains:
content - The main memory text (required)
tags - Array of categorization tags (e.g., ["player:Steve", "event:trade"])
context - Additional context about when/where the memory was created
importance - Priority level 1-10 (default 5)
created_at / updated_at - Timestamps
> Remember that Steve helped me find diamonds at coordinates -234, 12, 567
> Search my memories for anything about Steve
> List my most important memories (importance >= 8)
> What do I remember about trading?Node.js 18+
better-sqlite3 - SQLite bindings
@modelcontextprotocol/sdk - MCP server SDK
haksnbot-mind - Autonomous Minecraft bot using Claude Agent SDK
haksnbot-tools - Minecraft MCP tools
haksnbot-admin - Server administration MCP tools
MIT
This server cannot be deployed
Persistent memory for AI agents. Search, store, and recall across sessions.
Persistent memory for AI agents. Search and store durable facts, preferences and decisions.
Hosted persistent memory with semantic search, importance and TTL for AI agents.
Persistent memory for AI agents: add, search, update, and delete long-term memories.
