mcp server

adaptive-memory-graph

Intelligent persistent memory graph MCP plugin for Claude

raskolnikovdd/adaptive-memory-graphcommunitylistedunreviewed

Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

uv (`curl -LsSf https://astral.sh/uv/install.sh | sh`)

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "adaptive-memory-graph": {
      "command": "uvx",
      "args": [
        "adaptive-memory-graph"
      ]
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 17, 2026

Adaptive Memory Graph

An MCP server plugin that gives Claude persistent, intelligent memory across sessions. It stores knowledge as weighted, interconnected nodes in a graph that evolves through conversation — nodes that get used gain weight, unused ones decay and eventually archive.

Works with Claude Code and Claude Desktop.

Features

Weighted memory nodes — Important memories stay prominent; stale ones fade
Cross-domain connections — Link related knowledge across topics
Time-based decay — Graph self-prunes so only relevant memories persist
Encrypted storage — AES-256-GCM encryption with macOS Keychain key storage
Session logging — Tracks which memories were accessed and how they were received
Domain organization — Nodes organized by domain (e.g. health_and_safety, personal, ideas_and_projects)
Chat history ingestion — Review and extract knowledge from past Claude Code sessions

Installation

pip install adaptive-memory-graph

Or with uv:

uv pip install adaptive-memory-graph

Setup

Claude Code

claude mcp add adaptive-memory-graph -s user -- amg-server

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "adaptive-memory-graph": {
      "command": "amg-server"
    }
  }
}

Config file location:

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

Tools

Tool	Description
`amg_load_index`	Load lightweight graph index at session start
`amg_expand_branch`	Fetch full node content when contextually relevant
`amg_get_connected_nodes`	Find related nodes across domains
`amg_log_session`	Log session summary at conversation end
`amg_update_graph`	Process pending logs and apply weight decay
`amg_export_report`	Generate human-readable graph summary
`amg_manual_adjust`	Boost, decay, archive, or delete nodes
`amg_add_node`	Add new nodes to the graph
`amg_search_nodes`	Search nodes by title, summary, tags, or content
`amg_list_chat_sessions`	List available Claude Code chat sessions for review
`amg_read_chat_session`	Read a chat session's conversation content

How It Works

Session start — Claude calls amg_load_index to get a lightweight summary of your memory graph
During conversation — If a topic is relevant, Claude expands specific nodes for deeper context
Session end — Claude silently logs which nodes were accessed and suggests new ones
Between sessions — Weight decay runs, archiving memories that haven't been useful

Nodes are stored as encrypted JSON on disk (~/.amg/graph.json.enc). The encryption key is stored in your macOS Keychain.

Requirements

Python 3.10+
macOS (for Keychain-based encryption key storage)

License

MIT