Skip to main content
Glama
Semantic Memory MCP

Semantic Memory MCP

by Sceat

License: MIT Node.js Redis OpenAI

Semantic memory for AI agents. Store patterns, search by meaning, remember forever.

πŸ“– For LLMs: See ARCHITECTURE.md for detailed implementation & TESTING.md for tool reference


What This Does

Give your AI agents a brain that learns and remembers:

  • 🧠 Semantic Search: Find patterns by meaning, not keywords

  • πŸ’Ύ Three Memory Types: Semantic (forever), Episodic (90 days), Procedural (forever)

  • πŸ“ˆ Intelligence Compounds: Learn from every task, recall before you act

  • πŸ”„ Auto-Consolidation: Promotes validated patterns automatically

Related MCP server: Memsolus MCP Server

Quick Start

Install

claude mcp add memory -- npx -y github:Sceat/semantic-memory-mcp

Then configure environment variables in ~/.claude.json:

{
  "mcpServers": {
    "memory": {
      "env": {
        "REDIS_URL": "redis://localhost:6379/0",
        "OPENAI_API_KEY": "your-openai-key-here"
      }
    }
  }
}

Use

Six tools available immediately:

  • store_pattern - Save what you learned

  • search_patterns - Find similar patterns

  • set_reminder - Never forget important details

  • check_reminders - Get context before tasks

  • consolidate_memories - Promote validated patterns

  • health_check - Verify system status


How It Works

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                                                     β”‚
β”‚   Before Task: Query memory for similar patterns   β”‚
β”‚                Check reminders for this task type   β”‚
β”‚                                                     β”‚
β”‚   During Task: Execute with learned context        β”‚
β”‚                                                     β”‚
β”‚   After Task:  Store what you learned              β”‚
β”‚                Set reminders for next time          β”‚
β”‚                                                     β”‚
β”‚   Result: Intelligence compounds over time          β”‚
β”‚                                                     β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Local Development

If you want to develop or modify the server:

git clone https://github.com/Sceat/semantic-memory-mcp.git
cd semantic-memory-mcp
npm install

Then add to your Claude Code config:

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": ["/path/to/semantic-memory-mcp/src/index.js"],
      "env": {
        "REDIS_URL": "redis://localhost:6379/0",
        "OPENAI_API_KEY": "your-openai-key-here"
      }
    }
  }
}

Requirements

  • Node.js β‰₯ 18

  • Redis 7.2+ with RediSearch module

  • OpenAI API key

  • Claude Code


License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers