# neverinfamous-memory-journal-mcp

Keeps a running record of project work so a fresh AI session knows what came before. Decisions, fixes and past mistakes stay searchable.

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

## What it does

The server gives your agent a long-term record of a codebase. Entries are stored in a database searched two ways at once: keyword matching through FTS5 plus vector similarity, merged with reciprocal rank fusion. Ask why a service ended up on SQLite rather than Postgres a month back, and the agent looks it up instead of guessing.

GitHub work sits alongside the journal: issues, pull requests, Actions, Kanban, milestones and reviews. There are workflow prompts too, and a graph linking decisions, specs and PRs that can be drawn with Mermaid. Code Mode runs multi-step operations through an `mj.*` API; the author claims token savings up to 90%, which is worth measuring on your own repos.

Written in TypeScript, shipped on npm and as an Alpine Docker image. The setup shown below points at a remote HTTP endpoint, so nothing needs installing locally for that route. Run it yourself when the journal should stay with you: the database is shared, and entries are visible to teammates. GitHub tools need you to be authenticated with GitHub first; without that they will not work.

## Requirements
- Remote server: `https://server.smithery.ai/@neverinfamous/memory-journal-mcp/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http neverinfamous-memory-journal-mcp https://server.smithery.ai/@neverinfamous/memory-journal-mcp/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add neverinfamous-memory-journal-mcp --url https://server.smithery.ai/@neverinfamous/memory-journal-mcp/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "neverinfamous-memory-journal-mcp": {
            "url": "https://server.smithery.ai/@neverinfamous/memory-journal-mcp/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "neverinfamous-memory-journal-mcp": {
            "type": "http",
            "url": "https://server.smithery.ai/@neverinfamous/memory-journal-mcp/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http neverinfamous-memory-journal-mcp https://server.smithery.ai/@neverinfamous/memory-journal-mcp/mcp
```

## When to use it
- recover why one library was picked over another weeks ago
- hand working context to the next AI session without copying it by hand
- close an issue and log the reason behind an architectural fix
- trace how a spec connects to its implementation and pull request
- flag a blocker for a teammate so their agent picks it up

## Example prompts
- Why did we go with SQLite instead of Postgres for this service last month?
- Close issue #42 and write down how the parsing bug was fixed.
- Raise a blocker flag for @sarah — I'm stuck on a database error.

## 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