mcpField
M
mcp-windows

mcp-windows

Local
github.com/SecretiveShellOther23Updated 79w ago
Repository

About mcp-windows

mcp-windows is an MCP server that exposes Windows API functions to MCP clients. It suits users who want an AI client to control media, windows, theme and clipboard on a Windows desktop.

Key features

  1. 01Media session query and playback control
  2. 02Send Windows toast notifications
  3. 03Window listing, focus, minimize and close
  4. 04Window screenshots
  5. 05Monitor sleep and wake
  6. 06Light and dark theme switching
  7. 07Clipboard read and write

Use cases

  1. 01Controlling media playback from an AI client
  2. 02Managing open windows on a Windows desktop
  3. 03Reading or writing clipboard content

MCP support

This project is an MCP server that exposes Windows API functions as tools to MCP clients. It is launched from the client's mcpServers configuration using uvx or a local uv command.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "windows": {
      "command": "uvx",
      "args": [
        "mcp-windows"
      ]
    }
  }
}
Run commanduvx mcp-windows

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypimcp-windows

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

mcp-windows

MCP server for the windows API.

Installation

add this to your claude mcp config:

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

or locally:

{
  "mcpServers": {
    "windows": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Users\\{name}\\Documents\\mcp-windows",
        "run",
        "mcp-windows"
      ]
    }
  }
}

Features

Media
  • get_media_sessions
  • pause
  • play
  • next
  • previous
Notifications
  • send_toast
Window Management
  • get_foreground_window_info
  • get_window_list
  • focus_window
  • close_window
  • minimize_window
screenshot
  • screenshot_window
Monitors
  • sleep_monitors
  • wake_monitors
Theme
  • set_theme_mode (light, dark)
  • get_theme_mode
Start Menu
  • open_file
  • open_url
Clipboard
  • get_clipboard
  • set_clipboard

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.