# KEPTA — the memory for AI systems

> KEPTA — the memory for AI systems is a free MCP server for knowledge and memory. Local encrypted memory shared by Claude, Cursor and other MCP clients, in one file you own. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS, self-hosted, API
- **Repository:** https://github.com/damiantodorovic/kepta
- **MCP Registry name:** io.github.DamianTodorovic/kepta
- **Categories:** [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory)
- **Listing updated:** 2026-11-18

## About

K3PTA keeps what your AI learns in a single SQLCipher-encrypted database on your own machine, with the key held in the operating system keychain. Every connected client reads and writes the same memory, so a note saved from Claude can be recalled from Cursor or a script. There is no cloud and no account.

Retrieval combines full-text search, vectors and a knowledge graph, fused and reranked locally. The memory tracks what was true and when, so notes can be contradicted or superseded rather than just piled up, and a timeline command shows how facts changed. An import command brings in ChatGPT history, and a one-line setup command wires the server into clients such as Claude Desktop, Cursor, VS Code, Gemini CLI and Cline.

The core is source-available under BUSL-1.1 (converting to AGPL after four years), with a free desktop app for macOS and an HTTP API with 32 routes. Local writes stop at 5,000 active notes by default as a guard against runaway agents. Team and organisation features are sold separately as Enterprise. Needs Node 22.13 or newer.

## Features

- **Encrypted single file:** SQLCipher 4 with AES-256, key kept in the OS keychain.
- **Hybrid retrieval:** Full-text, vector and graph search fused and reranked locally.
- **One memory for every client:** Claude, Cursor, Gemini CLI, Cline and scripts share the same notes.
- **Time-aware notes:** Track what was true and when, with superseded facts kept.
- **Setup and import:** One command connects clients; ChatGPT exports can be imported.
- **Desktop app:** A free window for browsing memory, graph and search provenance.

## Good for

- Give every AI client the same persistent project memory
- Remember client details across chat sessions
- Move ChatGPT history into a private local store
- Script memory reads and writes through the HTTP API

## Install

### Claude Code (Terminal)

```sh
claude mcp add kepta -- npx -y kepta-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "kepta": {
      "command": "npx",
      "args": [
        "-y",
        "kepta-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "kepta": {
      "command": "npx",
      "args": [
        "-y",
        "kepta-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "kepta": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "kepta-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "kepta": {
      "command": "npx",
      "args": [
        "-y",
        "kepta-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "kepta": {
      "command": "npx",
      "args": [
        "-y",
        "kepta-mcp"
      ]
    }
  }
}
```

## Tools

- `memory_search`: Search stored memories.
- `memory_save`: Save a note.
- `memory_update`: Update a note.
- `memory_delete`: Delete a note.
- `memory_list`: List notes.
- `memory_graph`: Explore the knowledge graph.
- `memory_consolidate`: Consolidate memories.
- `memory_forget`: Forget a memory.

## FAQ

### Does it send data to the cloud?

No. The README says it is local, with no cloud and no account.

### What does it cost?

The core and desktop app are free; KEPTA Enterprise for teams is licensed by agreement.

### What Node version is needed?

Node 22.13 or newer.

### Is there a note limit?

Locally the API stops accepting new notes at 5,000 active by default, adjustable with KEPTA_MAX_ACTIVE.

### Is KEPTA — the memory for AI systems free?

Yes. KEPTA — the memory for AI systems is free to use.

### How do I add KEPTA — the memory for AI systems to Claude Code?

Run this command in your terminal: claude mcp add kepta -- npx -y kepta-mcp

### What are the best alternatives to KEPTA — the memory for AI systems?

The closest alternatives to KEPTA — the memory for AI systems are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and NeuroStack.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## 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.
- [NeuroStack](https://ai-powered.com/mcp/neurostack): NeuroStack is a freemium MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [Digitalnz](https://ai-powered.com/mcp/digitalnz): Digitalnz is a freemium MCP server for knowledge and memory.
- [Notion_connect](https://ai-powered.com/mcp/notion-connect): Notion_connect is a freemium MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/kepta-the-memory-for-ai-systems
