Page:
Home
Clone
3
Home
Jonathan Miller edited this page 2026-05-25 23:49:53 -05:00
Table of Contents
mcp-windows
MCP server for Windows desktop system operations -- audio, display, processes, services, power, files, and more.
| Type | MCP Server |
| Language | Node.js / TypeScript |
| Tools | 80 tools across 20+ categories |
| License | GPL-3.0-or-later |
| Platform | Gitea (primary) |
Overview
mcp-windows is a Model Context Protocol server that gives AI assistants full control over the Windows desktop. Unlike Desktop Commander (which focuses on files and terminal), mcp-windows provides native Windows integration -- audio control via COM, window management via Win32 P/Invoke, display configuration, power management, registry access, and more.
The server runs over stdio and is designed for Claude Code integration. All tools use PowerShell as the primary execution engine, with inline C# compilation for Win32 API access where needed.
Tool Categories
| Category | Tools | Description |
|---|---|---|
| Terminal | windows_execute, windows_terminal_* |
Shell commands and persistent REPL sessions |
| Process | windows_process_list, windows_process_kill |
Process management |
| Audio | windows_audio_get, windows_audio_set, windows_audio_app_volumes |
Volume, mute, per-app audio |
| System | windows_system_info |
OS, CPU, RAM, disk, network, uptime |
| File System | windows_file_read/write/edit, windows_search, windows_file_search |
File operations and search |
| Services | windows_service_list, windows_service_control |
Windows service management |
| Power | windows_power_get, windows_power_action |
Battery, power plans, sleep/shutdown |
| Network | windows_network_info, windows_network_connections |
Adapters, Wi-Fi, netstat |
| Drives | windows_drives |
Drive listing with capacity and usage |
| Display | windows_display_get/set, windows_screenshot |
Resolution, brightness, screenshots |
| Windows | windows_window_list, windows_window_control |
Window management via Win32 |
| Clipboard | windows_clipboard_get/set |
Text, files, images |
| Notifications | windows_notification_send |
Toast notifications |
| Registry | windows_registry_read/write |
Windows Registry access |
| Admin | env, startup, scheduler, apps, dialog, recycle bin, config | System administration |
| Bluetooth | windows_bluetooth_get/control |
Adapter and device management |
| Wi-Fi | windows_wifi_networks, windows_wifi_connect |
Network scanning and connections |
| USB | windows_usb_devices |
USB device listing with safe eject |
| Printers | windows_printer_list |
Printers, queues, defaults |
| Hosts | windows_hosts_file |
Hosts file management |
| Theme | windows_theme_get/set, windows_focus_mode, windows_default_apps |
Appearance and dark mode |
| Virtual Desktops | windows_virtual_desktop |
Create, switch, remove desktops |
| Firewall | windows_firewall_get/manage |
Rules and profiles |
| Maintenance | updates, event_log, restore_point, certificates, performance | System health |
| WSL | windows_wsl_list/manage/exec |
Windows Subsystem for Linux |
| Packages | windows_winget_search/manage/export |
winget package management |
| Storage | windows_disk_cleanup, windows_symlink |
Disk analysis and links |
| System Mgmt | timezone, features, smb_shares, dns_cache | System configuration |
| Automation | shortcut, input, font_list, sandbox, screen_capture | Desktop automation |
Wiki Pages
Guides
- Installation -- Setup, dependencies, and Claude Code registration
- Configuration -- Blocked commands, allowed directories, output limits
Reference
- API -- Complete tool reference with parameters and examples
- Architecture -- System design, source map, execution model
Related Wikis
| Repo | Purpose |
|---|---|
| mcp_mokossh | SSH remote server management |
| mcp_mokowaas | Joomla WaaS API |
| mcp_mokomonitor | Grafana monitoring |
MokoStandards -- central standards hub
Repo: mcp-windows · MokoStandards
| Revision | Date | Author | Description |
|---|---|---|---|
| 3.0 | 2026-05-25 | Moko Consulting | v3.0 -- 80 tools, WSL, winget, storage, automation |
| 1.0 | 2026-05-25 | Moko Consulting | Initial version |