Terminal History Mcp

Created By

HasanJahidula month ago

terminal-history-mcp gives AI agents (Claude Code, Cursor, Cline, Zed, any MCP client) full-text search over your shell history. - Local-only, no cloud — SQLite FTS5 at ~/.terminal-history-mcp/history.db - Supports zsh, bash, fish - Captures cwd, exit code, duration via opt-in shell hook - 11-pattern secret redaction runs BEFORE insert (GitHub PATs, OpenAI keys, AWS, JWTs, bearer tokens, env vars, CLI flags, basic-auth URLs) - Hash-deduped, idempotent reindex - WAL mode — safe across parallel sessions Ask: "When did I last ssh into staging?", "Show failed commands today", "What did I run in /etc/nginx yesterday?", "Show context around kubectl apply".

# terminal

# shell

Overview Content Tools Comments

Content

Terminal History MCP

Search your shell history (zsh / bash / fish) from Claude Code, Cursor, Cline, Zed, or any MCP client. Local-only. SQLite FTS5. Secret-redacted before storage.

demo

Why

"What was that long docker compose flag I used 3 weeks ago?"
"When did I last ssh into staging?"
"Show failed commands today."
"What did I run yesterday in /etc/nginx?"
"Show context around kubectl apply."

grep ~/.zsh_history | sort | uniq is not memory. This is.

Install

npm install -g terminal-history-mcp
terminal-history-mcp index           # one-time backfill
terminal-history-mcp install-hook    # opt-in: capture cwd / exit / duration

Or zero-install via npx:

{
  "mcpServers": {
    "terminal-history": {
      "command": "npx",
      "args": ["-y", "terminal-history-mcp"]
    }
  }
}

Tools

Tool	Purpose
`reindex`	Re-parse history files + extended log into FTS5 DB
`search_history`	FTS5 keyword + prefix search over command history
`recent_in_dir`	Commands run in a given working directory
`failed_commands`	Non-zero-exit commands since timestamp
`command_chains`	±5min context window around matches

Privacy / Security

Local-only. Nothing leaves your machine. DB at ~/.terminal-history-mcp/history.db.
Secrets redacted BEFORE insert — defense in depth, raw SQLite browse can't leak.
11 ordered patterns: GitHub PATs (ghp_*), OpenAI keys (sk-*), Slack tokens, AWS access keys, generic Token:/Key:/Secret:/ApiKey: headers, Authorization: Bearer/Basic, env-style FOO_TOKEN=val, CLI flags (--token=val, -k val), URL basic-auth (https://user:pass@host), JWTs.
WAL mode — concurrent shell sessions safe.

Shell support

Shell	History parse	Hook capture (cwd / exit / duration)
zsh	✅	✅ (`EPOCHREALTIME`)
bash	✅	✅ (`awk` ms math)
fish	✅	✅ (`date +%s%N`)

Tech

TypeScript (ESM), Node 18+
better-sqlite3 (sync, no callback hell)
FTS5 + porter + unicode61 — Unicode-safe, stems plurals
Hash-based dedupe (sha1(shell|ts|cmd)) — idempotent reindex
Zero network calls

Pairs with

localhost-mcp — what's currently running on which port. Together: full dev environment memory for AI agents (what you ran + what's running).

Source

GitHub: https://github.com/HasanJahidul/terminal-history-mcp
npm: https://www.npmjs.com/package/terminal-history-mcp
Hosted: https://mcpize.com/mcp/terminal-history
License: MIT

Server Config

{
  "mcpServers": {
    "terminal-history": {
      "command": "npx",
      "args": [
        "-y",
        "terminal-history-mcp"
      ]
    }
  }
}

Recommend Servers

TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.

Howtocook Mcp基于Anduin2017 / HowToCook （程序员在家做饭指南）的mcp server，帮你推荐菜谱、规划膳食，解决“今天吃什么“的世纪难题； Based on Anduin2017/HowToCook (Programmer's Guide to Cooking at Home), MCP Server helps you recommend recipes, plan meals, and solve the century old problem of "what to eat today"

Amap Maps高德地图官方 MCP Server

Jina AI MCP ToolsA Model Context Protocol (MCP) server that integrates with Jina AI Search Foundation APIs.

Zhipu Web SearchZhipu Web Search MCP Server is a search engine specifically designed for large models. It integrates four search engines, allowing users to flexibly compare and switch between them. Building upon the web crawling and ranking capabilities of traditional search engines, it enhances intent recognition capabilities, returning results more suitable for large model processing (such as webpage titles, URLs, summaries, site names, site icons, etc.). This helps AI applications achieve "dynamic knowledge acquisition" and "precise scenario adaptation" capabilities.

CursorThe AI Code Editor

Tavily Mcp

MCP AdvisorMCP Advisor & Installation - Use the right MCP server for your needs

ChatWiseThe second fastest AI chatbot™

Playwright McpPlaywright MCP server

RedisA Model Context Protocol server that provides access to Redis databases. This server enables LLMs to interact with Redis key-value stores through a set of standardized tools.