WORKSPACE KNOWLEDGE / Atuin
Atuin MCP
Let an agent search your shell history and retrieve captured command output without executing those commands.
“History search reads the Atuin database directly, so it works without any extra setup.”
01 / THE REASONING
Why this made the selection.
- History results connect a command with its directory, exit status and a reusable history identifier.
- Output search can locate the prior command behind an error message when output capture is enabled.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- Atuin MCP guide, workspace and atuin-ai Cargo manifests, and root MIT licence.
- crates/atuin-ai/src/mcp.rs: tool schemas, dispatcher and stdio startup.
Our findings
- The registered tools search history, retrieve output and search output; no command-execution tool is registered here.
- History search reads the local SQLite database; output retrieval delegates to the daemon.
Not established by this review
- Server launch, authenticated tool calls, and release-to-source parity were not tested.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Connect a server deliberately.
DOCUMENTED COMMAND
claude mcp add atuin -- atuin mcpCopying does not execute this command. It may retrieve a newer version than the reviewed source.
- Install and configure Atuin using its official guide, then confirm the binary is on the MCP client’s PATH.
- The command below adds the server to Claude Code; use the JSON example for other compatible clients.
- Enable output capture separately if you need printed output as well as command history.
Before you start
- An existing Atuin installation and recorded shell history.
- Daemon and pty-proxy for output capture features.
Documented configuration example
Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.
{
"mcpServers": {
"atuin": {
"command": "atuin",
"args": [
"mcp"
]
}
}
}04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- Atuin MCP setup and scope ↗Checked
https://raw.githubusercontent.com/atuinsh/atuin/12eb0279ca28bffe74bc1bd242451b613d8298ab/docs/docs/ai/mcp.md
Supports: summary, upstreamDescription, whySelected, bestFor, limitations, install, access, compatibility, transports, review
https://raw.githubusercontent.com/atuinsh/atuin/12eb0279ca28bffe74bc1bd242451b613d8298ab/crates/atuin-ai/src/mcp.rs
Supports: review, language, access, transports
- Atuin AI crate manifest ↗Checked
https://raw.githubusercontent.com/atuinsh/atuin/12eb0279ca28bffe74bc1bd242451b613d8298ab/crates/atuin-ai/Cargo.toml
Supports: language
- Atuin MIT licence ↗Checked
https://raw.githubusercontent.com/atuinsh/atuin/12eb0279ca28bffe74bc1bd242451b613d8298ab/LICENSE
Supports: license