This MCP server provides Windows API integration for Claude, allowing it to interact with various Windows system functions like media controls, notifications, window management, screenshots, and more.
To use the Windows MCP server with Claude, you need to add it to your Claude MCP configuration. You have two options for installation:
Add the following configuration to your Claude MCP config file:
{
"mcpServers": {
"windows": {
"command": "uvx",
"args": [
"mcp-windows"
]
}
}
}
For a local installation, use this configuration instead:
{
"mcpServers": {
"windows": {
"command": "uv",
"args": [
"--directory",
"C:\\Users\\{name}\\Documents\\mcp-windows",
"run",
"mcp-windows"
]
}
}
}
Replace {name}
with your Windows username.
The Windows MCP server allows Claude to control media playback:
Example usage:
// Get information about current media sessions
get_media_sessions
// Control playback
pause
play
next
previous
Send Windows toast notifications:
send_toast
Interact with windows on the system:
Example usage:
// Get information about windows
get_foreground_window_info
get_window_list
// Control windows
focus_window
close_window
minimize_window
Capture screenshots of specific windows:
screenshot_window
Control the system's monitors:
// Put monitors to sleep
sleep_monitors
// Wake monitors from sleep
wake_monitors
Manage the Windows theme mode:
// Set theme mode
set_theme_mode light
set_theme_mode dark
// Get current theme mode
get_theme_mode
Open files or URLs from Claude:
// Open files or applications
open_file
// Open a URL in the default browser
open_url
Access and modify the Windows clipboard:
// Read the current clipboard contents
get_clipboard
// Set new clipboard contents
set_clipboard
There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json
file so that it is available in all of your projects.
If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json
file.
To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".
When you click that button the ~/.cursor/mcp.json
file will be opened and you can add your server like this:
{
"mcpServers": {
"cursor-rules-mcp": {
"command": "npx",
"args": [
"-y",
"cursor-rules-mcp"
]
}
}
}
To add an MCP server to a project you can create a new .cursor/mcp.json
file or add it to the existing one. This will look exactly the same as the global MCP server example above.
Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.
The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.
You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.