light-agent-memory-mcp-server
Click on "Install 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., "@light-agent-memory-mcp-serverremember that I prefer pnpm for package management"
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.
light-agent-memory-mcp-server
MCP server for persistent agent memory — projects, preferences, and session learnings stored in a local SQLite database.
Harness-agnostic. Works with any MCP-compatible client: opencode, Claude Desktop, Cursor, Windsurf, etc.
Install
npm install -g light-agent-memory-mcp-serverOr use directly with npx (no install needed):
npx light-agent-memory-mcp-serverRelated MCP server: tartarus-mcp
Configure
Add to your MCP client's config:
opencode (~/.config/opencode/opencode.json):
{
"mcp": {
"memory": {
"type": "local",
"command": ["npx", "-y", "light-agent-memory-mcp-server"],
"enabled": true
}
}
}Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"memory": {
"command": "npx",
"args": ["-y", "light-agent-memory-mcp-server"]
}
}
}Cursor (.cursor/mcp.json):
{
"mcpServers": {
"memory": {
"command": "npx",
"args": ["-y", "light-agent-memory-mcp-server"]
}
}
}Custom database path
npx light-agent-memory-mcp-server --db /path/to/custom.dbTools
Project Memory
Tool | Description |
| Save/update project context (tech stack, architecture, conventions) |
| Get project details by name |
| List all saved projects |
Preference Memory
Tool | Description |
| Save/update a personal coding preference |
| Get a preference by key |
| List preferences (optionally filtered by category) |
Learning Memory
Tool | Description |
| Record a session learning (solution, insight, bug note) |
| Search learnings by keyword |
Generic
Tool | Description |
| Unified save (auto-routes by type) |
| Cross-type search by keyword |
| Delete a memory by type and ID |
| List all memories with pagination and stats |
Examples
Save a project:
memory_project_save({
name: "my-app",
path: "/home/user/projects/my-app",
tech_stack: ["TypeScript", "React", "SQLite"],
architecture: "Monorepo with pnpm workspaces, plugin-based architecture",
conventions: "ESM-only, strict TypeScript, no comments in code"
})Save a preference:
memory_pref_save({
key: "language.typescript.style",
value: "Always use ESM imports, strict mode, and prefer readonly types",
category: "language"
})Record a learning:
memory_learning_save({
title: "Fix SQLite WAL mode deadlock",
content: "When using WAL mode in SQLite, set busy_timeout to 5000ms to avoid SQLITE_BUSY errors under concurrent reads.",
project_name: "my-app",
tags: ["sqlite", "debugging", "concurrency"]
})Search all memories:
memory_search({ query: "SQLite" })Database
Data is stored in ~/.agent-memory/memory.db by default (SQLite via Node.js built-in node:sqlite). The database is created automatically on first run.
Schema
projects —
id,name(unique),path,tech_stack(JSON),architecture,conventions,notes, timestampspreferences —
id,key(unique),value,category, timestampslearnings —
id,title,content,project_name,tags(JSON), timestamps
Development
git clone https://github.com/AliYar-Khan/light-agent-memory-mcp-server.git
cd light-agent-memory-mcp-server
npm install
npm run build
npm run dev # runs with tsx, no build stepLicense
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceProvides persistent, local-first AI memory across sessions via MCP tools for storing, searching, and retrieving context from past interactions.1MIT
- AlicenseNot gradedqualityCmaintenanceA local-first MCP memory server providing persistent, searchable memory for AI agents, powered by SQLite.51Apache 2.0
- AlicenseNot gradedqualityAmaintenanceProvides persistent memory for AI coding agents via MCP, enabling agents to store and semantically recall facts, events, and lessons across sessions, all running locally without cloud dependencies.Apache 2.0
- AlicenseNot gradedqualityCmaintenancePersistent memory for AI coding agents. Enables agents to save and recall decisions, patterns, bugs, and context across sessions via an MCP server with local SQLite storage.452MIT
Related MCP Connectors
Shared, governed long-term memory for AI agents across tools and sessions via MCP and REST.
Persistent memory for AI agents. Search, store, and recall across sessions.
Your memory, everywhere AI goes. Build knowledge once, access it via MCP anywhere.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/AliYar-Khan/light-agent-memory-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server