# genesys-memory

This MCP server gives an AI agent persistent memory linked by cause and effect. Use it when context needs to carry across tasks.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 31
- Author: Astrix-Labs
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Astrix-Labs/papez
- Updated: 2026-09-07
- HTML: https://affpapa.org/en/nevibecode/mcp/genesys-memory

## What it does

genesys-memory stores context across tasks and connects facts through causal relationships. It exposes memory to an agent over MCP and is described as having 13 tools, including support for explaining stored memories.

The Claude Code setup runs `uvx genesys-memory`. Its install command passes `OPENAI_API_KEY` and `ANTHROPIC_API_KEY`; an alternate command also sets `GENESYS_EMBEDDER`. Those values need to be configured for the shown setup to run.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `GENESYS_EMBEDDER` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env OPENAI_API_KEY=<OPENAI_API_KEY> --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> --env GENESYS_EMBEDDER=<GENESYS_EMBEDDER> --transport stdio genesys-memory -- uvx genesys-memory
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from genesys-memory <command>

### Codex

**Platform CLI**
```bash
codex mcp add genesys-memory --env OPENAI_API_KEY=<OPENAI_API_KEY> --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> --env GENESYS_EMBEDDER=<GENESYS_EMBEDDER> -- uvx genesys-memory
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from genesys-memory <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "genesys-memory": {
            "command": "uvx",
            "args": [
                "genesys-memory"
            ],
            "env": {
                "OPENAI_API_KEY": "<OPENAI_API_KEY>",
                "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
                "GENESYS_EMBEDDER": "<GENESYS_EMBEDDER>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from genesys-memory <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "genesys-memory": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "genesys-memory"
            ],
            "env": {
                "OPENAI_API_KEY": "<OPENAI_API_KEY>",
                "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
                "GENESYS_EMBEDDER": "<GENESYS_EMBEDDER>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from genesys-memory <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e OPENAI_API_KEY=<OPENAI_API_KEY> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -e GENESYS_EMBEDDER=<GENESYS_EMBEDDER> genesys-memory uvx genesys-memory
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from genesys-memory <command>

## When to use it
- carry project context between agent tasks
- connect stored facts through causal relationships
- retrieve information saved in earlier work
- explain why a particular memory is relevant

## Example prompts
- Remember that we chose PostgreSQL for this project and why.
- Recall why we rejected the previous approach.
- Connect this decision to the reason behind it.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md