Windows System Control MCP server

Enables AI to control Windows system functions including media playback, notifications, window management, screenshots, monitor control, theme changes, clipboard access, and file operations.
Back to servers
Provider
SecretiveShell
Release date
Apr 18, 2025
Language
Python
Package
Stats
578 downloads
5 stars

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.

Installation

To use the Windows MCP server with Claude, you need to add it to your Claude MCP configuration. You have two options for installation:

Option 1: Global Installation

Add the following configuration to your Claude MCP config file:

{
  "mcpServers": {
    "windows": {
      "command": "uvx",
      "args": [
        "mcp-windows"
      ]
    }
  }
}

Option 2: Local Installation

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.

Features and Usage

Media Controls

The Windows MCP server allows Claude to control media playback:

  • Get information about active media sessions
  • Pause and play media
  • Skip to next or previous tracks

Example usage:

// Get information about current media sessions
get_media_sessions

// Control playback
pause
play
next
previous

Notifications

Send Windows toast notifications:

send_toast

Window Management

Interact with windows on the system:

  • Get information about the currently active window
  • Get a list of all open windows
  • Focus, close, or minimize specific windows

Example usage:

// Get information about windows
get_foreground_window_info
get_window_list

// Control windows
focus_window
close_window
minimize_window

Screenshot

Capture screenshots of specific windows:

screenshot_window

Monitor Controls

Control the system's monitors:

// Put monitors to sleep
sleep_monitors

// Wake monitors from sleep
wake_monitors

Theme Settings

Manage the Windows theme mode:

// Set theme mode
set_theme_mode light
set_theme_mode dark

// Get current theme mode
get_theme_mode

Start Menu

Open files or URLs from Claude:

// Open files or applications
open_file

// Open a URL in the default browser
open_url

Clipboard

Access and modify the Windows clipboard:

// Read the current clipboard contents
get_clipboard

// Set new clipboard contents
set_clipboard

How to add this MCP server to Cursor

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.

Adding an MCP server to Cursor globally

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"
            ]
        }
    }
}

Adding an MCP server to a project

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.

How to use the MCP server

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.

Want to 10x your AI skills?

Get a free account and learn to code + market your apps using AI (with or without vibes!).

Nah, maybe later