Skip to main content
Glama
donthemannn

Claude Continuity MCP Server

by donthemannn
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

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

Related MCP server: Claude TypeScript MCP Servers

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

Tool

Description

save_project_state

Save current project context and state

load_project_state

Restore saved project context

list_active_projects

View all tracked projects

get_project_summary

Get quick overview without loading full state

delete_project_state

Remove project (with safety confirmation)

update_project_context

Update 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

This server cannot be installed

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

How are these scores calculated?

Resources

Appeared in Searches

New MCP Servers

Latest Blog Posts

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