v1.7.0 - Auto-Decay Feature

Auto-Decay Feature

Memories now automatically lose importance over time if not accessed, making recent and frequently-used memories more prominent in search results.

Highlights

• Automatic Decay: Exponential decay based on time since last access (default half-life: 30 days)
• Smart Re-ranking: Search results ranked by similarity × effective_importance
• Access Count Bonus: Frequently accessed memories decay slower
• Background Persistence: Decay updates batched and persisted efficiently
• Zero Configuration: Works out of the box with sensible defaults

New Response Field

recall and hybrid_recall now return effective_importance alongside importance:

{
  "memories": [{
    "content": "...",
    "similarity": 0.95,
    "importance": 1.0,
    "effective_importance": 0.5
  }]
}

Configuration

Configure via environment variables:

SPATIAL_MEMORY_AUTO_DECAY_ENABLED=true
SPATIAL_MEMORY_AUTO_DECAY_PERSIST_ENABLED=true

Or in .mcp.json:

{
  "mcpServers": {
    "spatial-memory": {
      "command": "spatial-memory",
      "env": {
        "SPATIAL_MEMORY_AUTO_DECAY_ENABLED": "true"
      }
    }
  }
}

See docs/CONFIGURATION.md for full configuration reference.

Installation

pip install --upgrade spatial-memory-mcp

Full Changelog

See CHANGELOG.md for complete details.