# MCP Desktop Tools
An MCP server that gives Claude desktop automation capabilities — browser control, screenshots, mouse/keyboard input, window management, and clipboard access.
Built with TypeScript, Playwright, and native Windows APIs.
## Tools
### Browser
| Tool | Description |
|------|-------------|
| `browser_open` | Launch Chromium and navigate to a URL |
| `browser_navigate` | Navigate to a URL with configurable wait conditions |
| `browser_click` | Click elements by CSS selector |
| `browser_type` | Type into input fields, optionally clear or press Enter |
| `browser_read` | Read page content (text, HTML, title, URL, or specific elements) |
| `browser_screenshot` | Capture viewport or full-page screenshots |
| `browser_close` | Close the browser |
### Screenshots
| Tool | Description |
|------|-------------|
| `screenshot_fullscreen` | Capture entire screen (multi-monitor supported) |
| `screenshot_region` | Capture a rectangular region by coordinates |
| `screenshot_window` | Capture a specific window by title (partial match) |
### Desktop
| Tool | Description |
|------|-------------|
| `desktop_mouse_click` | Click at screen coordinates |
| `desktop_mouse_move` | Move cursor (instant or smooth animation) |
| `desktop_keyboard_type` | Type text via simulated keystrokes |
| `desktop_keyboard_hotkey` | Press keyboard shortcuts (e.g. ctrl+c, alt+tab) |
| `desktop_window_list` | List all visible windows with positions and sizes |
| `desktop_window_focus` | Focus a window by title |
| `desktop_window_resize` | Move and/or resize a window |
| `desktop_app_launch` | Launch apps by path, name, or URI |
| `desktop_clipboard_read` | Read clipboard text |
| `desktop_clipboard_write` | Write text to clipboard |
## Setup
```bash
npm install
npm run build
npx playwright install chromium
```
## Claude Code Configuration
Add to your Claude Code MCP settings (`~/.claude/settings.json`):
```json
{
"mcpServers": {
"desktop-tools": {
"command": "node",
"args": ["C:/Users/<you>/mcp-desktop-tools/dist/index.js"]
}
}
}
```
Restart Claude Code to pick up the new server.
## Requirements
- Windows 10/11
- Node.js 18+
- PowerShell (used for native window/mouse/keyboard operations)
## License
MIT
