--- title: "Atuin MCP: review, setup & limitations · Undominated.ai" canonical: https://undominated.ai/mcp-servers/atuin/ description: "Let an agent search your shell history and retrieve captured command output without executing those commands." --- # Atuin MCP: review, setup & limitations · Undominated.ai > Let an agent search your shell history and retrieve captured command output without executing those commands. [← Explore all mcp servers](/mcp-servers/) WORKSPACE KNOWLEDGE / Atuin # Atuin MCP Let an agent search your shell history and retrieve captured command output without executing those commands. See setup guidance ↓Original source ↗ SOURCE REVIEW Reviewed 2026-09-21 Evidence 4 linked sources Publisher Atuin Licence MIT ↗ Revision 12eb0279ca28 Read what was—and wasn’t—checked ↓ “History search reads the Atuin database directly, so it works without any extra setup.” Atuin · upstream description ↗ Our analysis follows below. 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. ### A good fit for - Recall how a project was built or debugged. - Inspect a previous command’s captured output. ### Weigh up before choosing - Shell history and terminal output can contain sensitive data; local storage does not stop the MCP client from sending results to a model provider. - Output tools require the Atuin daemon and output capture/pty-proxy setup. - Session filtering needs an Atuin-enabled parent shell, which editor-launched servers often lack. 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. Upstream setup instructions ↗ DOCUMENTED COMMAND claude mcp add atuin -- atuin mcp Copy command ↗ Copying 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" ] } } } Copy configuration ↗ ### Compatibility Claude Code · Cursor · Claude Desktop ### Implementation Rust ### Transports stdio ### Local process - Reads stored shell commands, paths, exit statuses and captured terminal output. - The documented tools are read-only; returned results leave the server process for the connected client. ### Cost model Runs on your machine; hosting and any connected model client are separate costs. 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 2026-09-21 https://raw.githubusercontent.com/atuinsh/atuin/12eb0279ca28bffe74bc1bd242451b613d8298ab/docs/docs/ai/mcp.md Supports: summary, upstreamDescription, whySelected, bestFor, limitations, install, access, compatibility, transports, review - Atuin MCP tool implementation ↗ Checked 2026-09-21 https://raw.githubusercontent.com/atuinsh/atuin/12eb0279ca28bffe74bc1bd242451b613d8298ab/crates/atuin-ai/src/mcp.rs Supports: review, language, access, transports - Atuin AI crate manifest ↗ Checked 2026-09-21 https://raw.githubusercontent.com/atuinsh/atuin/12eb0279ca28bffe74bc1bd242451b613d8298ab/crates/atuin-ai/Cargo.toml Supports: language - Atuin MIT licence ↗ Checked 2026-09-21 https://raw.githubusercontent.com/atuinsh/atuin/12eb0279ca28bffe74bc1bd242451b613d8298ab/LICENSE Supports: license KEEP COMPARING ## Other approaches to consider. Related by category or shared topics. These are alternatives to inspect, not a measured quality order. [### Knowledge Graph Memory reference server ↗ Persist named entities, observations and relations in a local JSONL graph between client sessions.](/mcp-servers/memory/)[### Notion MCP ↗ Searches and edits a Notion workspace through user-authorized remote tools, with plan-dependent access to connected-source search.](/mcp-servers/notion/)[### Fetch MCP reference server ↗ Retrieve a URL as text or Markdown in chunks through a small local MCP server.](/mcp-servers/fetch/) [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)