Back to Directory/Developer Tools

io.github.daedalus/mcp-external-memory

An MCP server that gives LLMs persistent, searchable semantic memory

Developer ToolsPythonv0.1.2

mcp-external-memory

An MCP server that gives LLMs persistent, searchable semantic memory.

PyPI Python Coverage Ruff

Install

pip install mcp-external-memory

Usage

from mcp_external_memory import memory_store, memory_search

# Store a memory
result = memory_store(content="Alice prefers dark mode", namespace="users", tags=["alice", "ui"])

# Search memories
results = memory_search(query="what does Alice prefer?", namespace="users")

CLI

mcp-external-memory --help

API

Tools

ToolDescription
memory_storePersist text + optional namespace/tags/metadata
memory_searchSemantic search (cosine similarity) over all memories
memory_getRetrieve a single memory by ID
memory_deleteDelete a memory by ID
memory_listList memories with optional namespace/tag filter + pagination
memory_statsCount of memories, namespaces, DB path
memory_updateUpdate an existing memory

Embedding Backends

The server supports multiple embedding backends:

  • TF-IDF (default): Pure Python, no external dependencies
  • OpenAI: Uses text-embedding-3-small model
  • Ollama: Local embeddings with Ollama

Set via MEMORY_EMBED_BACKEND environment variable.

Development

git clone https://github.com/daedalus/mcp-external-memory.git
cd mcp-external-memory
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/

MCP Registry

mcp-name: io.github.daedalus/mcp-external-memory

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
uvx mcp-external-memory

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-daedalus-mcp-external-memory": {
      "command": "uvx",
      "args": [
        "mcp-external-memory"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

mcp-external-memorypypi

Compatible MCP Clients

io.github.daedalus/mcp-external-memory works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More