What is the key difference between Terminal History MCP and Pty MCP?

Terminal History MCP belongs to the Command Line category with local stdio execution, while Pty MCP belongs to the Command Line category with local stdio execution.

How do I install Terminal History MCP or Pty MCP in Claude Desktop or Cursor?

Copy the mcpServers JSON configuration snippet provided on this page into your claude_desktop_config.json or ~/.cursor/mcp.json file and restart your AI client.

Are Terminal History MCP and Pty MCP free or paid?

Terminal History MCP operates under a Free / Open Source model (No auth required). Pty MCP operates under a Free / Open Source model (No auth required).

Which MCP server has more tools and community activity?

Terminal History MCP lists 5 tools with 1 views and 4 GitHub stars. Pty MCP lists 12 tools with 3 views and 16 GitHub stars.

Can I use both Terminal History MCP and Pty MCP together in the same MCP host?

Yes! MCP hosts like Claude Desktop, Cursor, Windsurf, Cline, and VS Code support configuring multiple servers under the mcpServers object simultaneously.

Side-by-Side Model Context Protocol Comparison

Terminal History MCP vs Pty MCP

In-depth architectural comparison of the Terminal History MCP and Pty MCP MCP servers. Compare execution transports, security boundaries, tool capabilities, quality scores, and ready-to-paste client installation snippets for Claude, Cursor, Windsurf, and VS Code.

At a Glance & Executive Verdict

Terminal History MCP

Command Line · Local stdio

Quality: 60/100 (Good) | Auth: No auth required

Pty MCP

Command Line · Local stdio

Quality: 52/100 (Good) | Auth: No auth required

Verdict Summary: Choose Terminal History MCP if you need specialized Command Line tools running via a local process. Choose Pty MCP if your workspace requires Command Line integration with local subprocess execution. Both servers can be configured concurrently in your client's mcpServers manifest.

Which MCP Server Should You Choose?

Choose Terminal History MCP when:

You need dedicated capabilities in the Command Line domain.
You prefer local stdio subprocess transport architecture.
Your security boundary fits: No auth required (Free / Open Source).
Primary tools included: reindex, search_history, recent_in_dir.

Explore Terminal History MCP Details

Choose Pty MCP when:

You need dedicated capabilities in the Command Line domain.
You prefer local stdio subprocess transport architecture.
Your security boundary fits: No auth required (Free / Open Source).
Primary tools included: create_local_session, create_ssh_session, create_serial_session.

Explore Pty MCP Details

Feature & Specification Comparison

Specification	Terminal History MCP HasanJahidul Command Line	Pty MCP raychao-oao Command Line
Summary	Full-text search over your shell history (zsh / bash / fish) via SQLite FTS5. Local-only. 11-pattern secret redaction runs BEFORE insert. Captures cwd / exit code / duration via opt-in shell hook. Tools: searchhistory, recentindir, failedcommands, commandchains, reindex.	Interactive PTY sessions for AI agents — local shells, SSH with persistent sessions (ai-tmux daemon for attach/detach), and serial ports. Single Go binary, no tmux dependency.
Category & Scope

Tools & Capabilities Breakdown

Terminal History MCP Tools (5)

reindex

Re-parses the local shell history files (`~/.zsh_history`, `~/.bash_history`) and the hook's extended log into the SQLite index. Idempotent — already-indexed commands are skipped by hash, so it is safe to call repeatedly. Run it after a burst of shell activity to make recent commands searchable. Reads only local files; writes only to `~/.terminal-history-mcp/`. Takes no arguments. Returns counts of parsed / inserted / skipped entries.

search_history

Read-only. Full-text search (SQLite FTS5, stemmed, Unicode-aware) over all indexed shell commands. Supports keyword and prefix queries — e.g. `docker build`, `git reb*`. Returns the most recent matches first, each with timestamp, shell, cwd, and exit code when available. Local index only; nothing is sent anywhere. If a query returns nothing you may need `reindex` first.

recent_in_dir

Read-only. Lists the most recent commands that were run with a given working directory — answers "what was I doing in this project?". Requires the shell hook to have been installed (legacy entries have no cwd and won't appear). Returns newest first with timestamps and exit codes. Local index only.

failed_commands

Ready-to-Paste Client Configurations

Paste either (or both) of these JSON server blocks into your client config file (e.g. claude_desktop_config.json or ~/.cursor/mcp.json).

Terminal History MCP Configuration

mcpServers (Claude Desktop / Cursor)

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

Pty MCP Configuration

mcpServers (Claude Desktop / Cursor)

{
  "mcpServers": {
    "raychao-oao-pty-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "raychao-oao-pty-mcp"
      ]
    }
  }
}

Frequently Asked Questions

Terminal History MCP is categorized under Command Line and uses a local stdio subprocess. In contrast, Pty MCP belongs to Command Line using local stdio subprocess. Select Terminal History MCP when you need capabilities focused on command line and Pty MCP when you require tools for command line.

More alternatives to Terminal History MCP More alternatives to Pty MCP Command Line category hub