---
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 ↓](#setup)[Original source ↗](https://raw.githubusercontent.com/atuinsh/atuin/406d4e844f5d319d88dc963c99b68205e25f0b93/docs/docs/ai/mcp.md)

SOURCE REVIEW

 Reviewed 2026-10-13
 Evidence 4 linked sources
 Publisher Atuin
 Licence [MIT ↗](https://raw.githubusercontent.com/atuinsh/atuin/406d4e844f5d319d88dc963c99b68205e25f0b93/LICENSE)
 Revision 406d4e844f5d
 [Read what was—and wasn’t—checked ↓](#review)

“History search reads the Atuin database directly, so it works without any extra setup.”

 [Atuin · upstream description ↗](https://raw.githubusercontent.com/atuinsh/atuin/406d4e844f5d319d88dc963c99b68205e25f0b93/docs/docs/ai/mcp.md) 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.
- With AI session capture enabled, the session tools return what users and agents wrote in earlier coding sessions. Treat those transcripts as sensitive in the same way as shell history.

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

 - mcp.rs at this commit registers six tools, all annotated read-only: atuin_history, atuin_output, atuin_output_search, atuin_ai_session_search, atuin_ai_session_list and atuin_ai_session_read. No command-execution tool is registered.
- History search reads the local SQLite database; output retrieval delegates to the daemon.
- Change since the 2026-09-21 review: the three atuin_ai_session_* tools are new. They search, list and read transcripts of captured AI coding-agent sessions (the source names Claude Code, Codex, opencode and pi) and need the daemon with AI session capture enabled. The docs page at this commit still describes only the three history and output tools.

### 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 ↗](https://raw.githubusercontent.com/atuinsh/atuin/406d4e844f5d319d88dc963c99b68205e25f0b93/docs/docs/ai/mcp.md)

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.
- Reads captured AI coding-agent session transcripts when the daemon has AI session capture enabled.

### 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 ↗](https://raw.githubusercontent.com/atuinsh/atuin/406d4e844f5d319d88dc963c99b68205e25f0b93/docs/docs/ai/mcp.md) Checked 2026-10-13 https://raw.githubusercontent.com/atuinsh/atuin/406d4e844f5d319d88dc963c99b68205e25f0b93/docs/docs/ai/mcp.md Supports: summary, upstreamDescription, whySelected, bestFor, limitations, install, access, compatibility, transports, review, configExample
- [Atuin MCP tool implementation ↗](https://raw.githubusercontent.com/atuinsh/atuin/406d4e844f5d319d88dc963c99b68205e25f0b93/crates/atuin-ai/src/mcp.rs) Checked 2026-10-13 https://raw.githubusercontent.com/atuinsh/atuin/406d4e844f5d319d88dc963c99b68205e25f0b93/crates/atuin-ai/src/mcp.rs Supports: review, language, access, transports, Tool list with read-only annotations, AI session tools
- [Atuin AI crate manifest ↗](https://raw.githubusercontent.com/atuinsh/atuin/406d4e844f5d319d88dc963c99b68205e25f0b93/crates/atuin-ai/Cargo.toml) Checked 2026-10-13 https://raw.githubusercontent.com/atuinsh/atuin/406d4e844f5d319d88dc963c99b68205e25f0b93/crates/atuin-ai/Cargo.toml Supports: language
- [Atuin MIT licence ↗](https://raw.githubusercontent.com/atuinsh/atuin/406d4e844f5d319d88dc963c99b68205e25f0b93/LICENSE) Checked 2026-10-13 https://raw.githubusercontent.com/atuinsh/atuin/406d4e844f5d319d88dc963c99b68205e25f0b93/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/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Inspect resource evidence](/tools/)
- [Choose a host](/agents/)
- [Inspect reusable workflows](/skills/)
- [Use Undominated data](/api/)
