claude-linux-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| screenshotA | Capture a screenshot of the full screen (or the active window if active_window=true). Saves a PNG under /tmp/claude-linux-mcp/shots/ and returns the path. |
| list_windowsA | List all visible windows with id, pid, desktop, geometry (x/y/width/height), hostname, and title. |
| focus_windowA | Bring a window matching the given title pattern (substring, case-insensitive per wmctrl) to the foreground. |
| move_windowA | Move and/or resize a window matching the given title pattern. Any of x, y, width, height omitted leaves that dimension unchanged. |
| close_windowA | Request a window matching the given title pattern to close (gracefully, via the WM close hint). |
| mouse_moveA | Move the mouse pointer to absolute screen coordinates (x, y). |
| mouse_clickA | Click a mouse button. If x and y are provided, the pointer moves there first; otherwise clicks at the current pointer location. |
| mouse_dragB | Drag from (x1, y1) to (x2, y2) while holding the given button (default left). |
| mouse_scrollA | Scroll in a direction (up/down/left/right) by N clicks (default 3). |
| type_textA | Type a string into the currently-focused window (emits keystrokes). Use key_press for special/modifier combos. |
| key_pressA | Press a keyboard combination using xdotool's keysym notation. Examples: 'ctrl+c', 'alt+Tab', 'super', 'Return', 'Escape', 'Page_Down'. |
| clipboard_getA | Read the current X11 CLIPBOARD selection as text. |
| clipboard_setA | Write a string to the X11 CLIPBOARD selection. |
| launch_appA | Launch an application via a shell command (e.g. "firefox", "gnome-terminal", "code /path/to/project"). The process is detached from this server. |
| screenshot_textA | Take a screenshot and OCR it with tesseract. Returns the recognized text plus the path to the underlying PNG. Use when Claude needs to READ what is on screen (log windows, error dialogs, terminal output in non-focused windows) rather than just see the image. Requires tesseract-ocr installed. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 15 tools
Each tool has a clearly distinct purpose covering clipboard operations, window management, keyboard input, mouse actions, app launching, and screenshot capture. No two tools overlap in functionality.
All tool names follow a consistent verb_noun pattern with snake_case (e.g., clipboard_get, close_window, mouse_click). The naming scheme is predictable and easy to parse.
15 tools is perfectly scoped for a desktop automation MCP server. Each tool addresses a distinct action without unnecessary redundancy, covering the essential operations for window management, input, and clipboard.
The tool surface covers the full lifecycle of desktop automation: window discovery and manipulation, input simulation (keyboard, mouse, clipboard), app launching, and screenshot capture with optional OCR. No obvious gaps are present for typical use cases.