# inkvault

Keeps supported Claude Code and Codex sessions, selected browser history, and work context in a local archive that an MCP client can search.

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

## What it does

inkvault copies supported Claude Code and Codex sessions, along with history from browser profiles you approve. It can also preserve Pieces records, while optional Windows capture adds app activity and text from selected apps. The archive lives in a local SQLite file named `vault.db`, and Memory Atlas lets you inspect results in context.

The MCP service exposes `search_memories`, `timeline`, `get_memory`, and `memory_stats`. An agent can query past work by meaning or keyword, inspect activity across a period, and retrieve a stored item. Setup runs through `uvx`, so `uv` must be installed before the connection command will work. Daily summaries use a local Ollama model, and screen capture is available on Windows as an optional feature.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add inkvault -- uvx inkvault
```
uvx runs the command named after the package; if the README names another one, use uvx --from inkvault <command>

### Codex

**Platform CLI**
```bash
codex mcp add inkvault -- uvx inkvault
```
uvx runs the command named after the package; if the README names another one, use uvx --from inkvault <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "inkvault": {
            "command": "uvx",
            "args": [
                "inkvault"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from inkvault <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "inkvault": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "inkvault"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from inkvault <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add inkvault uvx inkvault
```
uvx runs the command named after the package; if the README names another one, use uvx --from inkvault <command>

## When to use it
- preserve Claude Code and Codex sessions
- retrieve an old answer from the local archive
- trace work across a date range
- copy history from approved browser profiles
- inspect saved context through an MCP client

## Example prompts
- Search my saved context for how I fixed the retry error.
- Build a timeline of what I worked on during the week.
- Find the browser page I opened before configuring the project.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74569
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899

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