donthemannn/claude-continuity

Claude Continuity MCP Server

A Model Context Protocol (MCP) server that provides persistent memory and conversation continuity for Claude Desktop and Claude Code. Never lose your project context again when threads hit token limits.

Features

• 🔄 Automatic State Persistence - Saves project context and conversation state
• ⚡ Seamless Restoration - Instantly restore full context when starting new threads
• 🔒 Privacy First - All data stored locally in ~/.claude_states
• 📊 Multi-Project Support - Manage multiple concurrent projects
• 🗂️ Smart Organization - Automatic backup rotation and state management
• 🎯 Zero Configuration - Works immediately after setup

Installation

1. Clone or Download

# Clone to your home directory
cd ~
git clone https://github.com/yourusername/claude-continuity.git

# Or download and extract the files

2. Install Dependencies

cd ~/claude-continuity
pip3 install mcp

3. Configure Claude Desktop

Edit your Claude Desktop configuration:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Add this configuration:

{
  "mcpServers": {
    "claude-continuity": {
      "command": "/opt/homebrew/bin/python3.11",
      "args": ["/Users/yourusername/claude-continuity/server.py"],
      "env": {}
    }
  }
}

4. Configure Claude Code

Run this command to add globally:

claude mcp add --scope user claude-continuity python3 ~/claude-continuity/server.py

Usage

Available Tools

Example Usage

Save Project State:

save_project_state: 
  project_name="my-web-app"
  state={current work and context}
  summary="Setting up authentication system"
  context={files_modified, issues, next_steps}

Load Project State:

load_project_state: project_name="my-web-app"

List All Projects:

list_active_projects

Data Storage

All project states are stored locally at:

~/.claude_states/
├── project-name-1/
│   ├── state.json
│   ├── summary.txt
│   └── state.backup.*.json
└── project-name-2/
    ├── state.json
    ├── summary.txt
    └── state.backup.*.json

State Structure

Each saved state includes:

{
  "project_name": "my-project",
  "state": {
    // Your custom state object
  },
  "summary": "Human-readable summary",
  "context": {
    "files_modified": [],
    "issues": [],
    "next_steps": [],
    "dependencies": []
  },
  "updated_at": "2025-08-05T22:48:00Z",
  "version": 1
}

Troubleshooting

Server Not Connecting

1. Check Python installation:

python3 --version
# Should be 3.8 or higher

2. Test server directly:

python3 ~/claude-continuity/server.py
# Should show: "Claude Continuity Server initialized..."

3. Check Claude Desktop logs for errors

Permission Issues

chmod +x ~/claude-continuity/server.py

Python Path Issues

Update config to use full Python path:

{
  "command": "/usr/bin/python3",
  "args": ["/Users/yourusername/claude-continuity/server.py"]
}

Requirements

• Python 3.8+
• MCP SDK (pip install mcp)
• Claude Desktop or Claude Code

Project Structure

claude-continuity/
├── server.py           # Main MCP server
├── requirements.txt    # Python dependencies
├── README.md          # This file
├── LICENSE            # MIT License
└── .gitignore         # Git ignore file

How It Works

1. Automatic Detection: Server monitors conversation for project-related activities
2. Smart Saving: Automatically creates backups before overwriting states
3. Context Preservation: Maintains files, decisions, issues, and next steps
4. Seamless Recovery: Load entire project context with one command

Contributing

Contributions welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Test your changes
4. Submit a pull request

License

MIT License - see LICENSE file for details

Author

Created for the Claude community to solve the context loss problem once and for all.

Support

For issues or questions:

• Open an issue on GitHub
• Check existing issues for solutions

Before: 😫 Hit token limit → Lose all context → Re-explain everything
After: 😎 Hit token limit → Start new thread → load_project_state → Continue seamlessly