Skip to main content
Glama
AliYar-Khan

light-agent-memory-mcp-server

by AliYar-Khan

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-server

Or use directly with npx (no install needed):

npx light-agent-memory-mcp-server

Related 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.db

Tools

Project Memory

Tool

Description

memory_project_save

Save/update project context (tech stack, architecture, conventions)

memory_project_get

Get project details by name

memory_project_list

List all saved projects

Preference Memory

Tool

Description

memory_pref_save

Save/update a personal coding preference

memory_pref_get

Get a preference by key

memory_pref_list

List preferences (optionally filtered by category)

Learning Memory

Tool

Description

memory_learning_save

Record a session learning (solution, insight, bug note)

memory_learning_search

Search learnings by keyword

Generic

Tool

Description

memory_save

Unified save (auto-routes by type)

memory_search

Cross-type search by keyword

memory_delete

Delete a memory by type and ID

memory_list

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

  • projectsid, name (unique), path, tech_stack (JSON), architecture, conventions, notes, timestamps

  • preferencesid, key (unique), value, category, timestamps

  • learningsid, 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 step

License

MIT

A
license - permissive license
A
quality
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

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

  • A
    license
    Not graded
    quality
    C
    maintenance
    Provides persistent, local-first AI memory across sessions via MCP tools for storing, searching, and retrieving context from past interactions.
    1
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    A local-first MCP memory server providing persistent, searchable memory for AI agents, powered by SQLite.
    5
    1
    Apache 2.0
  • A
    license
    Not graded
    quality
    A
    maintenance
    Provides 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
  • A
    license
    Not graded
    quality
    C
    maintenance
    Persistent 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.
    45
    2
    MIT

View all related MCP servers

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.

View all MCP Connectors

Latest Blog Posts

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