HasanJahidul/terminal-history-mcp

What it does

Terminal History MCP is a Model Context Protocol server that enables full-text search capabilities over your shell command history. It works with bash, zsh, and fish shells, indexing your command history into a SQLite FTS5 database for fast, local searching. The tool includes security features like automatic pattern-based secret redaction before any data is stored.

Key features

• Full-text search across shell history using SQLite FTS5
• Support for multiple shells: bash, zsh, and fish
• Local-only processing - no cloud uploads or external dependencies
• 11 pre-configured secret redaction patterns applied before storage
• Optional shell hook integration to capture working directory, exit codes, and command duration
• Search history tool accessible via MCP protocol

How to set up

Installation involves cloning the repository and configuring the MCP server. You'll need to enable the optional shell hook in your shell configuration file to capture additional metadata like working directory and exit codes. Once configured, the tool integrates with MCP-compatible AI assistants to provide searchable access to your command history.