|
|
This privacy-first, self-hosted MCP server helps you organize chat history, summarize messages, search across past chats with AI β and keeps everything secure and fully under your control. |
Transform your Claude conversations into a searchable, organized knowledge base that grows with you
- π§ Infinite Memory - Claude remembers everything across unlimited conversations with intelligent auto-summarization
- π Your Data, Your Control - 100% local storage with zero cloud dependencies or privacy concerns
- π― Effortless Organization - Smart tags and folders that organize themselves around your workflow
- π Intelligent Merging - Automatically combines related conversations while eliminating duplicates
Storage health reports as UNHEALTHY due to async/await issue.
Updated methods to async that were missed earliers
- DiagnosticTool.run_health_checks()
- DiagnosticTool._check_storage_health()
- DiagnosticTool.generate_system_report()
- StatusMonitoringSystem.get_system_status()
- StatusMonitoringSystem.generate_full_report()curl -fsSL https://github.com/ukkit/memcord/raw/main/install.sh | bashThis will:
- Download and setup memcord
- Set Up Python Virtual Environment using uv
- Update claude_desktop_config.json & README.md with Installation Path
{
"mcpServers": {
"memcord": {
"command": "uv",
"args": [
"--directory",
"</path/to/memcord>",
"run",
"memcord"
],
"env": {
"PYTHONPATH": "</path/to/memcord>/src"
}
}
}
}Add MCP server for your project - check README.md for installation path
claude mcp add-json memcord '{"type":"stdio","command":"uv","args":["--directory","</path/to/memcord>","run","memcord"],"env":{"PYTHONPATH":"</path/to/memcord>/src"}}'Verify installation
claude mcp list
claude mcp get memcordAdd at top of your CLAUDE.md file
memcord_name "NAME_OF_YOUR_PROJECT"# Traditional installation method
git clone https://github.com/ukkit/memcord.git
cd memcord
uv venv
source .venv/bin/activate
uv pip install -e .
# Replace </path/to/memcord/> in claude_desktop_config.json to the path where you installed it manuallyComplete Installation Guide - Detailed setup for Claude Code, Claude Desktop, and other MCP applications.
# Create a memory slot and save conversation
memcord_name "project_meeting"
memcord_save "Our discussion about the new API design..."
memcord_save_progress
# Use existing memory slot
memcord_use "project_meeting" π
# Navigate timeline - select specific entries
memcord_select_entry "2 hours ago" # or "latest", index, timestamp π
# Privacy control - activate zero mode (no saving)
memcord_zero # No memory will be saved until switched to another slot
# Search and query your memories
memcord_search "API design decisions"
memcord_query "What did we decide about authentication?"
# Merge related conversations
memcord_merge ["project_meeting", "api_notes"] "consolidated_project" π
Refer to π Complete Tools Reference for Advanced Mode and detailed documentation for all 19 tools with examples and parameters.
β οΈ Documentation updates in progress
- π Installation Guide - Complete setup instructions for all MCP applications
- π Feature Guide - Complete list of features
- π Tools Reference - Detailed documentation for all 19 tools
- π₯ Import & Merge Guide - Comprehensive guide for Phase 3 features π
- π Search & Query Guide - Advanced search features and natural language queries
- ποΈ Usage Examples - Real-world workflows and practical use cases
- βοΈ Data Format Specification - Technical details and file formats
- π οΈ Troubleshooting - Common issues and solutions
π If you find this project helpful, consider:
- π Starring the repository on GitHub
- π€ Support Development
- π Reporting bugs and suggesting features
MIT License - see LICENSE file for details.