
Interminal
Gives Claude direct terminal access through seven tools: connect_ssh for remote shells, create_local for host execution, execute for running commands, and helpers for polling output, sending input, or killing processes. Long running commands return a command_id you can poll without blocking. The interesting bit is the Zellij integration. Without a multiplexer, each execute call is isolated and stateless. Install Zellij on the target machine and the AI automatically gets persistent sessions where cd, environment variables, and background processes stick around between calls. You can even attach to watch Claude work in real time. Ships as a uvx one liner, supports interactive prompts and control sequences.
- GitHub stars
- 2
- tools
- 6
- transport
- STDIO
- last updated
- May 28, 2026
Tools
6 toolsPublic tool metadata for what this MCP can expose to an agent.
connect_sshConnect to an SSH server; returns session_id and welcome banner.
Connect to an SSH server; returns session_id and welcome banner.
No parameter schema in public metadata yet.
executeRun a command locally (no session needed) or over SSH; returns output or status=partial + command_id.
Run a command locally (no session needed) or over SSH; returns output or status=partial + command_id.
No parameter schema in public metadata yet.
read_outputPoll a running command for new output without sending input.
Poll a running command for new output without sending input.
No parameter schema in public metadata yet.
respondSend text input to a command waiting at a prompt.
Send text input to a command waiting at a prompt.
No parameter schema in public metadata yet.
send_controlSend control keys: ctrl+c, ctrl+z, arrow keys, F-keys, etc.
Send control keys: ctrl+c, ctrl+z, arrow keys, F-keys, etc.
No parameter schema in public metadata yet.
disconnectClose an SSH session and release all resources.
Close an SSH session and release all resources.
No parameter schema in public metadata yet.
Sponsors
Readme
Interminal
Lightweight MCP server that gives AI assistants terminal access — SSH and local shells — with support for interactive and long-running commands.
Installation
# Run directly, no install needed (recommended)
uvx mcp-interminal
# Or install permanently
pip install mcp-interminal
Requires Python ≥ 3.11.
MCP Client Configuration
Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"interminal": {
"command": "uvx",
"args": ["mcp-interminal"]
}
}
}
Cursor / other clients: same command + args format above.
Tools
Details
- Repository
- github.com/qiuwenzheng/interminal
- Category
- Developer Tools
- Package
mcp-interminal- Transport
- STDIO
- Registry
- MCP registry, active