memcord

MEMCORD v2.3.7 (mcp server) 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.

Never Lose Context Again

Transform your Claude conversations into a searchable, organized knowledge base that grows with you

✨ Core Benefits

• 🧠 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

What's new in v2.3.7

Cross-Platform Support & MCP Compliance:

  - Windows PowerShell installer (install.ps1) for one-line installation
  - Centralized config-templates/ folder with platform-specific configs
  - Cross-platform config generator (scripts/generate-config.py)
  - Windows cmd /c wrapper support for proper process spawning
  - Updated MCP SDK version constraint to v1.22-2.0 for stability
  - Logging configuration to prevent stdout corruption in STDIO mode

  - Added Google Antigravity IDE configuration template
  - Full compatibility with Antigravity's MCP server integration

🚀 Quick Start

macOS / Linux:

curl -fsSL https://github.com/ukkit/memcord/raw/main/install.sh | bash

Windows (PowerShell):

irm https://github.com/ukkit/memcord/raw/main/install.ps1 | iex

This will:

• Download and setup memcord
• Set up Python virtual environment using uv
• Generate platform-specific MCP configuration files
• Configure Claude Desktop, Claude Code, VSCode, and Antigravity IDE

Configuration Templates

All MCP configuration templates are in config-templates/. After installation, run:

# Regenerate configs (useful after updates or path changes)
uv run python scripts/generate-config.py

# Windows users
uv run python scripts/generate-config.py --platform windows

# Preview changes without writing
uv run python scripts/generate-config.py --dry-run

Claude Desktop

Copy the generated claude_desktop_config.json to your Claude Desktop config location:

Or use the template from config-templates/claude-desktop/:

{
  "mcpServers": {
    "memcord": {
      "command": "uv",
      "args": ["--directory", "/path/to/memcord", "run", "memcord"],
      "env": {
        "PYTHONPATH": "/path/to/memcord/src",
        "MEMCORD_ENABLE_ADVANCED": "false"
      }
    }
  }
}

Windows users: Use config-templates/claude-desktop/config.windows.json which includes the required cmd /c wrapper.

VSCode with GitHub Copilot

Prerequisites:

• VSCode 1.102+ (MCP support is GA)
• GitHub Copilot subscription
• Organization/Enterprise MCP policy enabled (if applicable)

Setup:

The installer creates .vscode/mcp.json automatically. Or copy manually:

cp config-templates/vscode/mcp.json .vscode/mcp.json

The VSCode config uses ${workspaceFolder} variables, so no path replacement needed:

{
  "servers": {
    "memcord": {
      "command": "uv",
      "args": ["--directory", "${workspaceFolder}", "run", "memcord"],
      "env": {
        "PYTHONPATH": "${workspaceFolder}/src",
        "MEMCORD_ENABLE_ADVANCED": "false"
      }
    }
  }
}

GitHub Copilot Agent Mode: Once configured, memcord tools are available in Copilot agent mode. Use natural language:

• "Create a memory slot for this project"
• "Search my memories for API design decisions"
• "Query past conversations about authentication"

Complete VSCode Setup Guide - Detailed instructions for VSCode and GitHub Copilot integration.

Google Antigravity IDE

The installer generates .antigravity/mcp_config.json automatically. Or configure manually:

{
  "mcpServers": {
    "memcord": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/memcord", "run", "memcord"],
      "env": {
        "PYTHONPATH": "/absolute/path/to/memcord/src",
        "MEMCORD_ENABLE_ADVANCED": "false"
      }
    }
  }
}

Note: Antigravity requires absolute paths.

Claude Code CLI

The installer creates .mcp.json in the project root. Or add manually:

claude mcp add-json memcord '{"type":"stdio","command":"uv","args":["--directory","/path/to/memcord","run","memcord"],"env":{"PYTHONPATH":"/path/to/memcord/src"}}'

Windows users: Use cmd wrapper:

claude mcp add-json memcord '{"type":"stdio","command":"cmd","args":["/c","uv","--directory","C:\\path\\to\\memcord","run","memcord"],"env":{"PYTHONPATH":"C:\\path\\to\\memcord\\src"}}'

Verify installation:

claude mcp list
claude mcp get memcord

Add at top of your CLAUDE.md file:

memcord_name "NAME_OF_YOUR_PROJECT"

Manual Installation

git clone https://github.com/ukkit/memcord.git
cd memcord
uv venv
source .venv/bin/activate  # Windows: .venv\Scripts\Activate.ps1
uv pip install -e .

# Generate configuration files
uv run python scripts/generate-config.py

Update Existing Installation

cd /path/to/memcord
git pull
uv pip install -e .
uv run python scripts/generate-config.py  # Regenerate configs

Complete Installation Guide - Detailed setup for Claude Code, Claude Desktop, and other MCP applications.

💻 Basic Usage

# 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

💎 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.

Star History