← Back to Home
API
Complete MCP tool reference for mcp-windows. All 44 tools with parameters.
Terminal & Process Execution
windows_execute
Execute a shell command (PowerShell, cmd, or bash).
| Parameter |
Type |
Default |
Description |
command |
string |
required |
The command to execute |
shell |
pwsh | cmd | bash |
pwsh |
Shell to use |
timeout |
number |
30000 |
Timeout in milliseconds |
cwd |
string |
-- |
Working directory |
windows_process_list
List running processes.
| Parameter |
Type |
Default |
Description |
filter |
string |
-- |
Filter by process name (substring) |
sort |
cpu | memory | name |
memory |
Sort order |
limit |
number |
50 |
Max results |
windows_process_kill
Terminate processes by PID or name.
| Parameter |
Type |
Default |
Description |
pid |
number |
-- |
Process ID to kill |
name |
string |
-- |
Process name to kill (all matching) |
force |
boolean |
false |
Force termination |
windows_terminal_start
Start a persistent interactive terminal session.
| Parameter |
Type |
Default |
Description |
shell |
pwsh | cmd | bash | python | node | wsl |
pwsh |
Shell type |
windows_terminal_send
Send input to a running terminal session.
| Parameter |
Type |
Description |
pid |
number |
Session PID |
input |
string |
Text to send |
windows_terminal_read
Read output from a terminal session with pagination.
| Parameter |
Type |
Default |
Description |
pid |
number |
required |
Session PID |
offset |
number |
0 |
Line offset (negative = from end) |
length |
number |
-- |
Number of lines |
windows_terminal_list
List all active terminal sessions. No parameters.
windows_terminal_kill
Terminate a terminal session.
| Parameter |
Type |
Description |
pid |
number |
Session PID to terminate |
Audio & Volume
windows_audio_get
Get current audio state. No parameters.
Returns: volume (0-100), mute state, default device name.
windows_audio_set
Set audio volume or mute state.
| Parameter |
Type |
Description |
volume |
number (0-100) |
Volume level |
mute |
true | false | toggle |
Mute state |
windows_audio_app_volumes
List per-application audio sessions. Without parameters, lists all apps. Set app + volume/mute to modify.
| Parameter |
Type |
Description |
app |
string |
App name to target |
volume |
number (0-100) |
Volume to set |
mute |
true | false | toggle |
Mute state |
System Information
windows_system_info
Get comprehensive system information. No parameters.
Returns: OS, CPU, RAM, disk, network adapters, uptime.
windows_installed_apps
List installed applications.
| Parameter |
Type |
Default |
Description |
filter |
string |
-- |
Filter by name |
sort |
name | date | size |
name |
Sort order |
limit |
number |
50 |
Max results |
File System
windows_file_read
Read a file with line pagination.
| Parameter |
Type |
Default |
Description |
path |
string |
required |
Absolute file path |
offset |
number |
0 |
Line offset (negative = tail) |
length |
number |
200 |
Lines to return |
windows_file_write
Write or append to a file.
| Parameter |
Type |
Default |
Description |
path |
string |
required |
Absolute file path |
content |
string |
required |
Content to write |
mode |
write | append |
write |
Write mode |
windows_file_edit
Surgical find/replace.
| Parameter |
Type |
Default |
Description |
path |
string |
required |
Absolute file path |
old_string |
string |
required |
Text to find |
new_string |
string |
required |
Replacement text |
expected_count |
number |
-- |
Fail if count mismatches |
replace_all |
boolean |
false |
Replace all occurrences |
windows_search
Search files by name or content.
| Parameter |
Type |
Default |
Description |
type |
files | content |
required |
Search type |
pattern |
string |
required |
Glob or regex pattern |
path |
string |
. |
Directory to search |
case_sensitive |
boolean |
false |
Case-sensitive |
file_pattern |
string |
-- |
Filter files (content search) |
context_lines |
number |
0 |
Context around matches |
limit |
number |
50 |
Max results |
windows_file_search
Search files using PowerShell.
| Parameter |
Type |
Default |
Description |
query |
string |
required |
Search query |
path |
string |
C:\ |
Directory to search |
type |
name | content |
name |
Search type |
extension |
string |
-- |
File extension filter |
limit |
number |
30 |
Max results |
windows_drives
List all drives/volumes. No parameters.
windows_recycle_bin
Manage the Recycle Bin.
| Parameter |
Type |
Default |
Description |
action |
list | size | empty | restore |
list |
Action |
filter |
string |
-- |
Filter by filename |
limit |
number |
30 |
Max items (list) |
Services
windows_service_list
| Parameter |
Type |
Default |
Description |
filter |
string |
-- |
Filter by name (substring) |
status |
running | stopped | all |
all |
Status filter |
windows_service_control
| Parameter |
Type |
Description |
name |
string |
Service name |
action |
start | stop | restart | enable | disable |
Action |
Power Management
windows_power_get
Get power state. No parameters.
windows_power_action
| Parameter |
Type |
Description |
action |
sleep | hibernate | lock | shutdown | restart | logoff | plan |
Action |
delay |
number |
Delay in seconds |
cancel |
boolean |
Cancel scheduled shutdown |
plan |
balanced | performance | powersaver |
Power plan (with action=plan) |
Network
windows_network_info
Get network configuration. No parameters.
windows_network_connections
| Parameter |
Type |
Default |
Description |
state |
all | listen | established | time_wait | close_wait |
all |
State filter |
port |
number |
-- |
Port filter |
process_name |
string |
-- |
Process name filter |
limit |
number |
50 |
Max results |
Display & Screenshot
windows_display_get
Get display configuration. No parameters.
windows_display_set
| Parameter |
Type |
Description |
resolution |
string |
Resolution as WIDTHxHEIGHT |
brightness |
number (0-100) |
Screen brightness (laptops) |
windows_screenshot
| Parameter |
Type |
Default |
Description |
target |
screen | window | region |
screen |
Capture target |
monitor |
number |
0 |
Monitor index |
window_title |
string |
-- |
Window title (for window) |
x, y, width, height |
number |
-- |
Region bounds |
save_path |
string |
-- |
Save to file instead of base64 |
Window Management
windows_window_list
| Parameter |
Type |
Description |
filter |
string |
Filter by title (substring) |
windows_window_control
| Parameter |
Type |
Description |
title |
string |
Window title (substring) |
pid |
number |
Process ID |
action |
minimize | maximize | restore | close | focus | move | resize | topmost |
Action |
x, y |
number |
Position (for move) |
width, height |
number |
Size (for resize) |
topmost |
boolean |
Always-on-top state |
Clipboard
windows_clipboard_get
Read clipboard contents. No parameters.
windows_clipboard_set
| Parameter |
Type |
Description |
text |
string |
Text to copy |
files |
string[] |
File paths to copy |
clear |
boolean |
Clear clipboard |
Notifications
windows_notification_send
| Parameter |
Type |
Default |
Description |
title |
string |
required |
Title |
body |
string |
required |
Body text |
icon |
string |
-- |
Icon file path |
sound |
boolean |
true |
Play sound |
Registry
windows_registry_read
| Parameter |
Type |
Default |
Description |
path |
string |
required |
Registry path (HKCU:, HKLM:, etc.) |
value |
string |
-- |
Specific value name |
subkeys |
boolean |
false |
List subkeys instead |
windows_registry_write
| Parameter |
Type |
Default |
Description |
path |
string |
required |
Registry path |
name |
string |
required |
Value name |
value |
string |
required |
Value data |
type |
String | DWord | QWord | Binary | ExpandString | MultiString |
String |
Value type |
hklm_override |
boolean |
false |
Allow HKLM writes |
action |
set | delete | create_key | delete_key |
set |
Action |
Environment Variables
windows_env_get
| Parameter |
Type |
Default |
Description |
name |
string |
-- |
Variable name (omit to list all) |
scope |
user | system | both |
both |
Scope |
windows_env_set
| Parameter |
Type |
Default |
Description |
name |
string |
required |
Variable name |
value |
string |
-- |
Value |
scope |
user | system |
user |
Scope |
action |
set | remove | append_path | prepend_path |
set |
Action |
Startup Items
windows_startup_list
List all startup items. No parameters.
windows_startup_manage
| Parameter |
Type |
Default |
Description |
action |
add | remove | enable | disable |
required |
Action |
name |
string |
required |
Item name |
command |
string |
-- |
Command (for add) |
location |
registry | startup_folder |
registry |
Where to add |
Task Scheduler
windows_task_scheduler_list
| Parameter |
Type |
Default |
Description |
folder |
string |
\ |
Task folder path |
filter |
string |
-- |
Filter by name |
windows_task_scheduler_manage
| Parameter |
Type |
Description |
action |
create | delete | enable | disable | run |
Action |
name |
string |
Task name |
command |
string |
Command (for create) |
arguments |
string |
Arguments (for create) |
trigger |
once | daily | weekly | hourly | logon | startup |
Trigger type |
time |
string |
Time as HH:mm |
interval |
number |
Minutes (for hourly) |
Dialogs
windows_dialog
| Parameter |
Type |
Default |
Description |
type |
message | input | file_open | file_save | folder |
required |
Dialog type |
title |
string |
mcp_windows |
Title |
message |
string |
-- |
Message text |
buttons |
ok | okcancel | yesno | yesnocancel |
ok |
Buttons (message) |
filter |
string |
-- |
File filter |
default_path |
string |
-- |
Default path |
Configuration
windows_mcp_config
| Parameter |
Type |
Default |
Description |
action |
get | set |
get |
Action |
key |
string |
-- |
Config key |
value |
string |
-- |
Value (JSON for arrays) |
Repo: mcp-windows · MokoStandards
| Field |
Value |
| Minimum Version |
05.00.00 |
| Platform |
mcp-server |
| Applies To |
mcp-windows |
| Revision |
Date |
Author |
Description |
| 1.0 |
2026-05-25 |
Moko Consulting |
Initial version |