# LLMSlim memory

> LLMSlim memory is an open-source MCP server for knowledge and memory. Local long-term memory for agents that returns the relevant context within a token budget. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API
- **Website:** https://llmslim.app
- **Repository:** https://github.com/thanatos9404/llmslim
- **MCP Registry name:** io.github.Thanatos9404/llmslim
- **Categories:** knowledge and memory, AI models and LLM tooling
- **Listing updated:** 2026-11-14

## About

LLMSlim memory stores what users and agents say word for word in a local SQLite file, then returns the parts that answer a question within a token budget you set. No language model is called in the loop, so there are no API keys or network calls for the default extractive strategy.

The same engine runs as this MCP server, a Python library or a small HTTP server, and the README gives setup commands for Claude Code, Codex, GitHub Copilot CLI, Gemini CLI and a Hermes Agent plugin. Environment variables choose the database file, whose memory the server holds and an optional agent id so each agent keeps its own memory. Postgres and MongoDB backends are available through extras.

The core is MIT-licensed and free. The site describes a planned hosted edition called Orbit, expected to open with version 1.0, and a self-hosted Vault in private beta.

## Features

- **No LLM in the loop:** Selection and compression run locally without a model call.
- **Token-budgeted recall:** Search returns the passages that answer a question within your budget.
- **Per-agent memory:** Set a user id and agent id so memories stay separate.
- **Local SQLite storage:** Memory lives in a file, by default ~/.llmslim/memory.db.
- **Library and HTTP server:** Use it from Python, TypeScript or a small server.
- **Framework adapters:** Adapters exist for LangChain, LlamaIndex, Haystack, gptme and Pydantic AI.

## Good for

- Give a coding agent memory that persists between sessions
- Fit long chat histories into a fixed token budget
- Keep separate memories for several agents
- Compress retrieved documents before a model call
- Run agent memory offline

## Install

### Claude Code (Terminal)

```sh
claude mcp add llmslim -- uvx llmslim
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "llmslim": {
      "command": "uvx",
      "args": [
        "llmslim"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "llmslim": {
      "command": "uvx",
      "args": [
        "llmslim"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "llmslim": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "llmslim"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "llmslim": {
      "command": "uvx",
      "args": [
        "llmslim"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "llmslim": {
      "command": "uvx",
      "args": [
        "llmslim"
      ]
    }
  }
}
```

## FAQ

### Does it need an API key?

No. The default extractive strategy runs in your process without one.

### Where is memory stored?

In SQLite at ~/.llmslim/memory.db unless LLMSLIM_MEMORY_DB points elsewhere.

### What licence is the core under?

MIT.

### Is there a hosted version?

The site describes Orbit as opening with LLMSlim 1.0, planned for 8 December 2026.

### Is LLMSlim memory free?

Yes. LLMSlim memory is open source, so you can use and self-host it for free.

### How do I add LLMSlim memory to Claude Code?

Run this command in your terminal: claude mcp add llmslim -- uvx llmslim

### What are the best alternatives to LLMSlim memory?

The closest alternatives to LLMSlim memory are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.
- [Context Nest](https://ai-powered.com/mcp/context-nest): Context Nest is a freemium MCP server for knowledge and memory.
- [Tulsa Ecosystem Map](https://ai-powered.com/mcp/tulsa-ecosystem-map): Tulsa Ecosystem Map is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/llmslim-memory
