Total PC Control

@jasondsmith72

About Total PC Control

Total PC Control MCP server - v2 with fixes and compression

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "total-pc-control": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/total-pc-control/build/index.js"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Total PC Control?

Total PC Control is an MCP (Model Context Protocol) server that provides programmatic control over your screen, mouse, and keyboard using nut.js. It is designed for users who want to enable AI models (via MCP-compatible clients like Claude for Desktop) to perform direct computer interactions such as screen capture, mouse movement, typing, window management, and clipboard operations.

How to use Total PC Control?

After cloning the repository, install cmake-js globally, build the libnut core library, then install dependencies and build the project. Configure your MCP client (e.g., Claude for Desktop) by editing its configuration file to point to the built build/index.js file and restart the client. The hammer icon in Claude indicates available tools.

Key features of Total PC Control

Screen capture of full screen or specific regions
Mouse control: move, click, double-click, scroll, and drag
Keyboard input: type text, press keys, and use shortcuts
Window management: find, focus, and manipulate windows
Clipboard access: read and write text and images
UI Automation tools for Windows (via PowerShell)

Use cases of Total PC Control

Automate repetitive desktop tasks through AI assistance
Enable AI to navigate and interact with application UIs
Perform remote or automated testing of GUI elements
Copy/paste data between applications programmatically

FAQ from Total PC Control

What are the prerequisites for using Total PC Control?

Node.js 16 or higher, npm or yarn, and cmake-js (installed globally) are required. Additionally, the libnut core library must be built locally.

Is Total PC Control safe to use?

The README explicitly warns that giving AI models direct control over your computer can lead to unintended consequences. The software controls your mouse, keyboard, and system functions, and you use it entirely at your own risk; the creators accept no responsibility for any damage or data loss.

Which platforms are supported?

The server relies on nut.js, which supports Windows, macOS, and Linux. Additionally, the UI Automation tools (get_ui_element_info, invoke_ui_element_action) work on Windows only.

How do I integrate Total PC Control with Claude for Desktop?

Edit the Claude for Desktop configuration file (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json; Windows: %APPDATA%\Claude\claude_desktop_config.json) and add an entry for "total-pc-control" pointing to the absolute path of build/index.js. Restart Claude for Desktop.

What tools are available in Total PC Control?

Tools are grouped into Screen Capture, Mouse Control, Keyboard Input, Clipboard Operations, and UI Automation. Examples include capture_screen, move_mouse, type_text, set_clipboard_text, and get_ui_element_info. Full tool lists with parameters are in the README.

Frequently asked questions

What are the prerequisites for using Total PC Control?

Node.js 16 or higher, npm or yarn, and cmake-js (installed globally) are required. Additionally, the libnut core library must be built locally.

Is Total PC Control safe to use?

Which platforms are supported?

The server relies on nut.js, which supports Windows, macOS, and Linux. Additionally, the UI Automation tools (get_ui_element_info, invoke_ui_element_action) work on Windows only.

How do I integrate Total PC Control with Claude for Desktop?

Edit the Claude for Desktop configuration file (macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`; Windows: `%APPDATA%\Claude\claude_desktop_config.json`) and add an entry for "total-pc-control" pointing to the absolute path of `build/index.js`. Restart Claude for Desktop.

What tools are available in Total PC Control?

Tools are grouped into Screen Capture, Mouse Control, Keyboard Input, Clipboard Operations, and UI Automation. Examples include `capture_screen`, `move_mouse`, `type_text`, `set_clipboard_text`, and `get_ui_element_info`. Full tool lists with parameters are in the README.