# Ghost MCP server

> Provides verified background desktop control for agents on Windows and Linux, allowing automation of apps without APIs, windows, shell, and browsers.

- Repository: https://github.com/NORTHTEKDevs/ghost
- Page: https://hostedmcp.org/servers/northtekdevs/ghost
- Transport: stdio
- Stars: 28
- License: MIT
- Latest version: 0.23.4

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `GHOST_VISION_API_KEY` | no | yes | Not needed for agents: the model driving Ghost reads ghost_see and ghost_screenshot itself. Only enables the optional built-in vision tier for description targets (any OpenAI-compatible vision endpoint). |
| `GHOST_VISION_API_KEY` | no | yes | Not needed for agents: the model driving Ghost reads ghost_see and ghost_screenshot itself. Only enables the optional built-in vision tier for description targets (any OpenAI-compatible vision endpoint). |
| `GHOST_FOCUS_LOCK` | no | no |  |
| `GHOST_FOCUS_POLICY` | no | no |  |

## FAQ

### Does Ghost take control of my mouse and keyboard while I work?

No, Ghost is designed to run in the background without stealing focus or moving your cursor. It uses window messages and UI Automation to interact with apps while you continue working in other windows.

### How does Ghost ensure that an action was actually successful?

Ghost uses an act-then-verify loop where it re-checks the screen or reads the control's value back after an action to confirm it worked.
