# Engram MCP server

> Stores every AI conversation verbatim and lets an AI client search past sessions by meaning across MCP clients.

- Repository: https://github.com/get-engram/engram
- Page: https://hostedmcp.org/servers/get-engram/engram
- Transport: remote
- Stars: 22
- Latest version: 0.1.1

## Install

### Claude Code

```sh
claude mcp add --transport http engram https://mcp.getengram.app/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.getengram.app/mcp"
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "engram": {
      "type": "http",
      "url": "https://mcp.getengram.app/mcp"
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"engram","type":"http","url":"https://mcp.getengram.app/mcp"}'
```

### Codex

```sh
codex mcp add engram --url https://mcp.getengram.app/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.engram]
url = "https://mcp.getengram.app/mcp"
```

### Gemini CLI

```sh
gemini mcp add -s user --transport http engram https://mcp.getengram.app/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.getengram.app/mcp",
      "type": "http"
    }
  }
}
```

## Tools (8)

- `create_conversation`
- `append_messages`
- `search`
- `get_conversation`
- `list_conversations`
- `delete_conversation`
- `memory_status`
- `whoami`

## FAQ

### How do I connect Engram to Claude Code?

Add the Engram plugin from its marketplace and install it, then restart Claude Code and approve access in the browser. No API key or config file is needed.

### Does Engram need an API key?

No, the server implements the MCP authorization flow with PKCE, so the client registers itself and signs you in through the browser. A free account is created during sign-in.

### How does Engram search stored conversations?

It performs semantic search across all conversations using bge-base-en-v1.5 embeddings, so you find context by meaning rather than exact keywords.

### Are conversations compressed or summarized when stored?

No, every message is stored exactly as sent with no summarization or compression, and memory is permanent within plan message limits.

### Which tools does Engram expose over MCP?

It exposes 8 core tools including create_conversation, append_messages, search, get_conversation, list_conversations, delete_conversation, memory_status and whoami. API-key connections also get secrets vault tools.
