Skip to main content
Glama

Claude Continuity MCP Server

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

ToolDescription
save_project_stateSave current project context and state
load_project_stateRestore saved project context
list_active_projectsView all tracked projects
get_project_summaryGet quick overview without loading full state
delete_project_stateRemove project (with safety confirmation)
update_project_contextUpdate just context/metadata

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
  1. Test server directly:
python3 ~/claude-continuity/server.py # Should show: "Claude Continuity Server initialized..."
  1. 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

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

A Model Context Protocol server that provides persistent memory and conversation continuity for Claude Desktop and Claude Code, allowing users to save and restore project context when threads hit token limits.

  1. Features
    1. Installation
      1. 1. Clone or Download
      2. 2. Install Dependencies
      3. 3. Configure Claude Desktop
      4. 4. Configure Claude Code
    2. Usage
      1. Available Tools
      2. Example Usage
    3. Data Storage
      1. State Structure
    4. Troubleshooting
      1. Server Not Connecting
      2. Permission Issues
      3. Python Path Issues
    5. Requirements
      1. Project Structure
        1. How It Works
          1. Contributing
            1. License
              1. Author
                1. Support

                  Related MCP Servers

                  • -
                    security
                    F
                    license
                    -
                    quality
                    A Model Context Protocol server for Claude Desktop that provides structured memory management across chat sessions, allowing Claude to maintain context and build a knowledge base within project directories.
                    Last updated -
                    2
                    TypeScript
                  • A
                    security
                    A
                    license
                    A
                    quality
                    A collection of Model Context Protocol servers that enable Claude Desktop to provide development assistance capabilities with filesystem, Git, shell command, and web search functionality without incurring API usage costs.
                    Last updated -
                    2
                    19
                    TypeScript
                    MIT License
                    • Apple
                  • A
                    security
                    A
                    license
                    A
                    quality
                    A Model Context Protocol server that allows Claude Desktop to manage and execute tasks in a queue-based system, supporting planning, execution, and completion phases.
                    Last updated -
                    10
                    1,345
                    5
                    TypeScript
                    MIT License
                    • Apple
                  • A
                    security
                    F
                    license
                    A
                    quality
                    A Model Context Protocol server that allows integration with Claude Desktop by creating and managing custom tools that can be executed through the MCP framework.
                    Last updated -
                    731
                    TypeScript
                    • Apple

                  View all related MCP servers

                  MCP directory API

                  We provide all the information about MCP servers via our MCP API.

                  curl -X GET 'https://glama.ai/api/mcp/v1/servers/donthemannn/claude-continuity'

                  If you have feedback or need assistance with the MCP directory API, please join our Discord server