# VibeDNA Journal

> VibeDNA Journal is a free MCP server for knowledge and memory. One markdown journal per project that your AI must read before it edits or runs anything. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, Windows, macOS, self-hosted
- **Website:** https://vibedna.ai/store/journal
- **Repository:** https://github.com/marstudio360/vibedna-journal-mcp
- **MCP Registry name:** io.github.marstudio360/vibedna-journal-mcp
- **Categories:** knowledge and memory, developer tools
- **Listing updated:** 2026-11-16

## About

The idea is that an assistant already has notes, but nothing makes it read the right one at the moment it acts. Journals DNA keeps a plain markdown journal per project of what shipped, what broke and what was decided, and in Claude Code a mod hands the relevant journal brief to the AI on its first touch of a file or command. Codex, GitHub Copilot and Cursor have beta adapters that deliver the same brief; in other apps the AI gets the journals but must choose to read them.

Several safeguards ride along. When a later entry changes a decision or price, the older one is shown with the newer entry beside it. A default rules pack stops once on a secret written to a file, a delete that wipes a folder, losing unsaved git work, DROP or DELETE without WHERE, a force push to main and overwriting .env files, and waits for a yes before publishing, spending or messaging customers. Status lines such as active or paused are flagged to be checked live.

Everything is files on your disk, so nothing is stored on the vendor's side and no account is needed. A local search index finds entries by meaning across projects, and journals can be opened in Obsidian. It does not write code; it keeps the reasons behind it.

## Features

- **Journal before action:** The mod puts the relevant journal in front of the AI before it edits or runs a command.
- **Newest word wins:** Outdated decisions and prices are shown next to the newer entry.
- **Default safety rules:** Stops once on leaked secrets, wiping deletes, force pushes and similar.
- **Approval gates:** Publishing, spending and messaging customers wait for a yes.
- **Cross-project search:** A local model finds entries by meaning, even in another language.
- **Plain files:** Journals are markdown on your disk and open in Obsidian.

## Good for

- Resume a project after a long break with the decisions intact
- Stop an agent repeating a fix you already rejected
- Hand work to another AI or teammate by sending the journal
- Guard against destructive commands in an AI session

## Install

### Claude Code (Terminal)

```sh
claude mcp add vibedna-journal-mcp -- npx -y https://github.com/marstudio360/vibedna-journal-mcp/releases/download/v1.0.3/vibedna-journal-mcp-1.0.3.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "vibedna-journal-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/marstudio360/vibedna-journal-mcp/releases/download/v1.0.3/vibedna-journal-mcp-1.0.3.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "vibedna-journal-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/marstudio360/vibedna-journal-mcp/releases/download/v1.0.3/vibedna-journal-mcp-1.0.3.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "vibedna-journal-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/marstudio360/vibedna-journal-mcp/releases/download/v1.0.3/vibedna-journal-mcp-1.0.3.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "vibedna-journal-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/marstudio360/vibedna-journal-mcp/releases/download/v1.0.3/vibedna-journal-mcp-1.0.3.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "vibedna-journal-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/marstudio360/vibedna-journal-mcp/releases/download/v1.0.3/vibedna-journal-mcp-1.0.3.mcpb"
      ]
    }
  }
}
```

## FAQ

### Does it need an account?

No. The site says it is files on your disk, not a service.

### Which AI apps get the full mod?

Claude Code; Codex, Cursor and GitHub Copilot have beta adapters.

### What happens in other apps?

The AI gets the journals but must choose to read them.

### Is it free?

The pricing page lists Journals DNA among the free tools.

### Is VibeDNA Journal free?

Yes. VibeDNA Journal is free to use.

### How do I add VibeDNA Journal to Claude Code?

Run this command in your terminal: claude mcp add vibedna-journal-mcp -- npx -y https://github.com/marstudio360/vibedna-journal-mcp/releases/download/v1.0.3/vibedna-journal-mcp-1.0.3.mcpb

### What are the best alternatives to VibeDNA Journal?

The closest alternatives to VibeDNA Journal are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/vibedna-journal
