Weasley DeepMind — Claude Code MCP server: install
Weasley DeepMind is an MCP server for Claude Code that stores typed memory fragments and retrieves linked context. Agents access it through stdio or HTTP.
Apache-2.0 ★ 6 updated 2026-11-05
claude mcp add --env DATABASE_URL=<DATABASE_URL> --env WEASLEY_DEEPMIND_AUTO_MIGRATE=<WEASLEY_DEEPMIND_AUTO_MIGRATE> --env EMBEDDING_API_KEY=<EMBEDDING_API_KEY> --transport stdio weasley-deepmind -- npx -y weasley-deepmindWhat Weasley DeepMind does
Weasley DeepMind gives an AI agent a self-hosted memory store for facts, decisions, procedures, preferences, episodes, and errors. It keeps provenance and links, then combines keyword search with graph neighbors and optional vector ranking through pgvector. The tool set includes remember, recall, reflect, context, forget, amend, and memory-history operations.
The server can run as a local stdio process or expose the Streamable HTTP endpoint /mcp. HTTP requests are rejected when WEASLEY_DEEPMIND_ACCESS_KEY is missing. Node.js 20.19 or newer and PostgreSQL 15 or newer with pgvector are required; Redis 7 is optional for caching and keyword lookup. An EMBEDDING_API_KEY is used when an external embedding provider is selected.
What it helps with
- carry project decisions across agent sessions
- retrieve linked context without replaying the whole conversation
- search stored memories with keywords and graph relations
- amend or retract an earlier memory fragment
- trace how a memory changed over time
Example prompts for the agent
- Remember the authentication decision for this project and link it to the current ticket.
- Find memories about the PostgreSQL migration and build context for this task.
- Trace the history of the caching decision in the project memory.
How to install Weasley DeepMind
Platform CLI
claude mcp add --env DATABASE_URL=<DATABASE_URL> --env WEASLEY_DEEPMIND_AUTO_MIGRATE=<WEASLEY_DEEPMIND_AUTO_MIGRATE> --env EMBEDDING_API_KEY=<EMBEDDING_API_KEY> --transport stdio weasley-deepmind -- npx -y weasley-deepmindReplace <…> with your own values
Platform CLI
codex mcp add weasley-deepmind --env DATABASE_URL=<DATABASE_URL> --env WEASLEY_DEEPMIND_AUTO_MIGRATE=<WEASLEY_DEEPMIND_AUTO_MIGRATE> --env EMBEDDING_API_KEY=<EMBEDDING_API_KEY> -- npx -y weasley-deepmindReplace <…> with your own values
Config file
{
"mcpServers": {
"weasley-deepmind": {
"command": "npx",
"args": [
"-y",
"weasley-deepmind"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>",
"WEASLEY_DEEPMIND_AUTO_MIGRATE": "<WEASLEY_DEEPMIND_AUTO_MIGRATE>",
"EMBEDDING_API_KEY": "<EMBEDDING_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"weasley-deepmind": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"weasley-deepmind"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>",
"WEASLEY_DEEPMIND_AUTO_MIGRATE": "<WEASLEY_DEEPMIND_AUTO_MIGRATE>",
"EMBEDDING_API_KEY": "<EMBEDDING_API_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e DATABASE_URL=<DATABASE_URL> -e WEASLEY_DEEPMIND_AUTO_MIGRATE=<WEASLEY_DEEPMIND_AUTO_MIGRATE> -e EMBEDDING_API_KEY=<EMBEDDING_API_KEY> weasley-deepmind npx -y weasley-deepmindReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Weasley DeepMind
How do I install Weasley DeepMind in Claude Code?
Run claude mcp add weasley-deepmind -e DATABASE_URL=<DATABASE_URL> -e EMBEDDING_API_KEY=<EMBEDDING_API_KEY> -- npx -y weasley-deepmind. This registers the MCP server with the PostgreSQL connection and embedding-provider key.
What does Weasley DeepMind do?
It stores small typed memory fragments, connects related evidence, and retrieves relevant context for an AI agent through MCP. It supports local stdio and the /mcp HTTP endpoint.
What does Weasley DeepMind need to run?
It requires Node.js 20.19 or newer plus PostgreSQL 15 or newer with the pgvector extension. HTTP mode requires WEASLEY_DEEPMIND_ACCESS_KEY; Redis 7 and EMBEDDING_API_KEY are optional components for the matching features.