ContextKeep Banner

ContextKeep 🧠

Infinite Long-Term Memory for AI Agents

Donate with PayPal

ContextKeep is a powerful, standalone memory server that gives your AI tools (Claude, Cursor, VS Code, Gemini, OpenCode) a persistent, searchable brain. Stop repeating yourself—let your AI remember.

Features • Installation • Usage • Web Dashboard • Configuration

🌟 Features

♾️ Infinite Context: Store unlimited project details, preferences, and snippets.
💰 Save Money & Tokens: Reduce context window usage by only retrieving relevant memories, lowering API costs.
🔌 Universal Compatibility: Works with any MCP-compliant client via Stdio (Local) or SSE (Remote).
🖥️ Modern Web Dashboard: Manage your memories visually with Grid, List, and Calendar views.
🔒 Privacy First: 100% local storage. Your data never leaves your machine.
🔎 Smart Search: Find exactly what you need with semantic and keyword search.
🐧 Linux Service: Runs silently in the background as a system service.

ContextKeep Showcase

🚀 Installation

Prerequisites

Python 3.10 or higher
Git (optional)

Quick Start

Clone the repository:
git clone https://github.com/mordang7/ContextKeep.git cd ContextKeep
Run the Installer:
- Linux/Mac:
  python3 install.py
- Windows:
  python install.py
Follow the Wizard: The installer will create a virtual environment, install dependencies, and generate a custom configuration file for you.

🔌 Configuration

After installation, you will find a mcp_config.json file in the root directory. Copy its contents into your AI client's configuration.

Example Configurations

1. Claude Desktop / Gemini CLI (Local)

{ "mcpServers": { "context-keep": { "command": "/absolute/path/to/ContextKeep/venv/bin/python", "args": ["/absolute/path/to/ContextKeep/server.py"] } } }

2. Remote Access (SSH)

Perfect for running ContextKeep on a home server (e.g., Raspberry Pi) and accessing it from your laptop.

{ "mcpServers": { "context-keep": { "command": "ssh", "args": [ "-i", "/path/to/private_key", "user@192.168.1.X", "'/path/to/ContextKeep/venv/bin/python'", "'/path/to/ContextKeep/server.py'" ] } } }

3. SSE Mode (Http)

If you prefer HTTP transport (great for OpenCode or web apps):

{ "mcpServers": { "context-keep": { "transport": "sse", "url": "http://localhost:5100/sse" } } }

🌐 Web Dashboard

ContextKeep includes a beautiful web interface to manage your memories.

URL: http://localhost:5000
Features:
- Dashboard: Overview of recent memories.
- Calendar: Visual timeline of your work.
- Search: Instant filtering.
- CRUD: Create, Read, Update, Delete memories manually.

To start it manually:

./venv/bin/python webui.py

🐧 Linux Service Setup (Optional)

Run ContextKeep as a background service (systemd) on Linux/WSL:

chmod +x install_services.sh ./install_services.sh

This will install:

contextkeep-server (Port 5100)
contextkeep-webui (Port 5000)

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

☕ Support the Project

If ContextKeep helps you build cool things, consider buying me a coffee!

Donate with PayPal

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

ContextKeep