inkvault — Claude Code MCP server: features and setup
Keeps supported Claude Code and Codex sessions, selected browser history, and work context in a local archive that an MCP client can search.
claude mcp add inkvault -- uvx inkvaultWhat inkvault 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.
What it helps with
- 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 for the agent
- 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.
How to install inkvault
Platform CLI
claude mcp add inkvault -- uvx inkvaultuvx runs the command named after the package; if the README names another one, use uvx --from inkvault <command>
Platform CLI
codex mcp add inkvault -- uvx inkvaultuvx runs the command named after the package; if the README names another one, use uvx --from inkvault <command>
Config file
{
"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>
Config file
{
"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>
Platform CLI
gemini mcp add inkvault uvx inkvaultuvx runs the command named after the package; if the README names another one, use uvx --from inkvault <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about inkvault
How do I install inkvault in Claude Code?
Run claude mcp add inkvault -- uvx inkvault.
What does inkvault do?
It stores supported AI sessions, approved browser history, and related records in a local SQLite archive. MCP tools let an agent search and retrieve that context during a conversation.
What does inkvault require?
You need uv and a terminal. Windows is required for optional screen capture, while daily digests use a local model through Ollama.
