Skip to main content
Glama
adeeljames

Claude Memory MCP

by adeeljames

🧠 Claude Memory MCP

A lightweight Model Context Protocol (MCP) server that gives Claude Desktop persistent memory across conversations. It stores, summarizes, and retrieves conversation history so Claude always remembers your context.


✨ Features

Feature

Description

Persistent Memory

Saves every conversation turn to a local memory.json file

Auto-Summarization

Automatically compresses history after 10 turns to keep context lean

Fast Context Loading

Returns summary + last 3 turns on demand β€” no bloat

One-command Setup

Powered by uv β€” no virtualenv juggling needed

Zero Latency

Runs locally over stdio β€” no network calls


Related MCP server: mcp-assist-memory

πŸ› οΈ Tools Exposed

Tool

Description

get_context

Load compressed memory (summary + last 3 turns). Call at the start of every conversation.

save_turn

Save one conversation turn. Call after every AI response.

clear_memory

Wipe all stored memory and start fresh.


πŸš€ Quick Start

Prerequisites

  • Python 3.13+

  • uv installed

1. Clone & Install

git clone https://github.com/adeeljames/claude-memory-mcp.git
cd claude-memory-mcp
uv sync

2. Run the MCP Server (for testing)

uv run python server.py

3. Add to Claude Desktop

Open your Claude Desktop config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Add the following under mcpServers:

{
  "mcpServers": {
    "memory-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/claude-mcp-optimize",
        "python",
        "server.py"
      ]
    }
  }
}

Replace /absolute/path/to/claude-mcp-optimize with the actual path on your machine.

Restart Claude Desktop β€” the memory-mcp server will appear in your tools list.


πŸ“ Project Structure

claude-memory-mcp/
β”œβ”€β”€ server.py           # MCP server β€” all tools defined here
β”œβ”€β”€ memory.json         # Runtime memory file (auto-created, gitignored)
β”œβ”€β”€ pyproject.toml      # uv project config & dependencies
β”œβ”€β”€ uv.lock             # Locked dependency graph
└── README.md           # You are here

βš™οΈ How It Works

Claude Desktop ──stdio──► server.py ──► memory.json
                                          β”‚
                         β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                         β”‚
                    get_context()     β†’ returns summary + last 3 turns
                    save_turn()       β†’ appends to history, triggers summary at 10 turns
                    clear_memory()    β†’ resets everything

πŸ”§ Dependencies

Package

Purpose

mcp>=1.26.0

Model Context Protocol SDK

All dependencies are managed by uv and pinned in uv.lock.


πŸ“„ License

MIT β€” free to use, modify, and share.


Made with love by @muhammadadeelai

Install Server
F
license - not found
A
quality
D
maintenance

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    -
    quality
    A
    maintenance
    An MCP server that provides a shared memory layer for Claude across claude.ai, Claude Code CLI, and Desktop, storing revisioned memory entries, session timelines, handoffs, and uploaded artifacts in SQLite.
    Last updated
  • A
    license
    A
    quality
    B
    maintenance
    A persistent memory MCP server for Claude Code that automatically saves conversations and retrieves relevant history across sessions to provide context.
    Last updated
    17
    11
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    A zero-dependency MCP server for cross-session memory recall in Claude Code. Provides lexical search, listing, and retrieval of past session memories to avoid re-explaining context.
    Last updated
    3
    14
    MIT

View all related MCP servers

Related MCP Connectors

  • Cloud-hosted MCP server for durable AI memory

  • User-owned memory for AI agents, Copilot, Claude, IDEs, CLIs, and chat apps over remote MCP.

  • One memory, every AI: Claude, ChatGPT, Perplexity, Gemini, Cursor, OpenClaw, Hermes, any MCP client.

View all MCP Connectors

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/adeeljames/claude-memory-mcp'

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