HasanJahidul/terminal-history-mcp

Overview

A TypeScript MCP server that enables searching shell history (zsh, bash, fish) from Claude. It uses local SQLite with FTS5 for full-text search and redacts secrets from the history.

Best for

Best for
Developers who want to query their shell history from within Claude or other MCP-compatible assistants

Use cases

• Finding a previously used command during a Claude conversation
• Querying shell history with full-text search without leaving the chat
• Reviewing terminal history while keeping sensitive data hidden

How to use

Install

npm install -g terminal-history-mcp

Tools exposed

• search_history
• recent_in_dir
• failed_commands
• command_chains
• reindex

Tested with

Claude Code, Cline, Cursor, Zed, ChatGPT

Example client config

[object Object]

Notes

A TypeScript MCP server that enables searching shell history (zsh, bash, fish) from Claude. It uses local SQLite with FTS5 for full-text search and redacts secrets from the history.

2 stars on GitHub. Last updated 2026-05-11. Licensed MIT.

Use cases

• Finding a previously used command during a Claude conversation
• Querying shell history with full-text search without leaving the chat
• Reviewing terminal history while keeping sensitive data hidden

Pros

• Fast full-text search via SQLite FTS5
• Redacts sensitive information from history
• Supports zsh, bash, and fish shells

Cons

• Low community adoption (2 stars)
• Requires an MCP client like Claude Desktop
• Only searches local shell history, not remote or shared histories

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.