Console Automation MCP Server

Production-ready MCP server for AI-driven console automation and monitoring. 40+ tools for session management, SSH, testing, and background jobs.

Local serverstdioPython

What is the Console Automation MCP server?

Production-ready MCP server for AI-driven console automation and monitoring. 40+ tools for session management, SSH, testing, and background jobs. Exposed over MCP by the console automation mcp server, that capability becomes something an assistant can invoke while it works, not something you go and do afterwards.

What it actually does

Model Context Protocol (MCP) server for controlled interaction with local console applications and remote SSH sessions, including output monitoring, error detection, and long-running workflows.

Adding it to your client

console-automation-mcp on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Its toolset

Everything the assistant can do here goes through one of these:

  • console_create_session — Create local or SSH console sessions
  • console_send_input — Send text input to sessions
  • console_send_key — Send special keys (Enter, Ctrl+C, etc.)
  • console_get_output — Get filtered/paginated output with advanced search
  • console_get_stream — Stream output from long-running processes
  • console_wait_for_output — Wait for specific patterns
  • console_stop_session — Stop sessions
  • console_list_sessions — List all active sessions
  • console_cleanup_sessions — Clean up inactive sessions
  • console_execute_command — Execute commands with output capture
  • console_detect_errors — Analyze output for errors
  • console_get_resource_usage — Get system resource stats

Configuration

You will need one environment variable: MCP_SESSION_PERSISTENCE_PATH. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

  • Node.js >= 18.0.0 - Windows, macOS, or Linux operating system - Optional serial-port integrations can require platform build tools.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Console Automation.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the console automation mcp server does with a few real requests.

When to reach for it

Plenty of monitoring and observability servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Console Automation's toolset — console_create_session, console_send_input, console_send_key and 11 more — is a fair guide to whether it matches your workflow.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Available tools

ToolWhat it does
console_create_sessionCreate local or SSH console sessions
console_send_inputSend text input to sessions
console_send_keySend special keys (Enter, Ctrl+C, etc.)
console_get_outputGet filtered/paginated output with advanced search
console_get_streamStream output from long-running processes
console_wait_for_outputWait for specific patterns
console_stop_sessionStop sessions
console_list_sessionsList all active sessions
console_cleanup_sessionsClean up inactive sessions
console_execute_commandExecute commands with output capture
console_detect_errorsAnalyze output for errors
console_get_resource_usageGet system resource stats
console_clear_outputClear output buffers
console_get_session_stateGet session execution state

How to install the Console Automation MCP server

{
  "mcpServers": {
    "github-com-ooples-mcp-console-automation": {
      "command": "npx",
      "args": ["-y", "console-automation-mcp"],
      "env": {
        "MCP_SESSION_PERSISTENCE_PATH": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • Node.js >= 18.0.0 - Windows, macOS, or Linux operating system - Optional serial-port integrations can require platform build tools.
VariableDescriptionRequired
MCP_SESSION_PERSISTENCE_PATHFilesystem location the server is allowed to use.Optional

Example prompts to try

  • Use Console Automation to console create session.
  • Use Console Automation to console send input.
  • Use Console Automation to console send key.

Frequently asked questions

It connects Console Automation to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (console_create_session, console_send_input, console_send_key, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Console Automation directly.