| Name | iflow-mcp_windows-mcp JSON |
| Version |
0.1.0
JSON |
| download |
| home_page | None |
| Summary | Lightweight MCP Server for interacting with Windows Operating System. |
| upload_time | 2025-08-14 07:24:03 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.13 |
| license | MIT License Copyright (c) 2025 JEOMON GEORGE Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
| keywords |
windows
mcp
ai
desktop
ai agent
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<div align="center">
<h1>🪟 Windows-MCP</h1>
<a href="https://github.com/CursorTouch/Windows-MCP/blob/main/LICENSE">
<img src="https://img.shields.io/badge/license-MIT-green" alt="License">
</a>
<img src="https://img.shields.io/badge/python-3.13%2B-blue" alt="Python">
<img src="https://img.shields.io/badge/platform-Windows%207–11-blue" alt="Platform: Windows 7 to 11">
<img src="https://img.shields.io/github/last-commit/CursorTouch/Windows-MCP" alt="Last Commit">
<br>
<a href="https://x.com/CursorTouch">
<img src="https://img.shields.io/badge/follow-%40CursorTouch-1DA1F2?logo=twitter&style=flat" alt="Follow on Twitter">
</a>
<a href="https://discord.com/invite/Aue9Yj2VzS">
<img src="https://img.shields.io/badge/Join%20on-Discord-5865F2?logo=discord&logoColor=white&style=flat" alt="Join us on Discord">
</a>
</div>
<br>
**Windows MCP** is a lightweight, open-source project that enables seamless integration between AI agents and the Windows operating system. Acting as an MCP server bridges the gap between LLMs and the Windows operating system, allowing agents to perform tasks such as **file navigation, application control, UI interaction, QA testing,** and more.
## Updates
- Try out 🪟[Windows-Use](https://github.com/CursorTouch/Windows-Use)!!, an agent built using Windows-MCP.
- Windows-MCP is now featured as Desktop Extension in `Claude Desktop`.
### Supported Operating Systems
- Windows 7
- Windows 8, 8.1
- Windows 10
- Windows 11
## 🎥 Demos
<https://github.com/user-attachments/assets/d0e7ed1d-6189-4de6-838a-5ef8e1cad54e>
<https://github.com/user-attachments/assets/d2b372dc-8d00-4d71-9677-4c64f5987485>
## ✨ Key Features
- **Seamless Windows Integration**
Interacts natively with Windows UI elements, opens apps, controls windows, simulates user input, and more.
- **Use Any LLM (Vision Optional)**
Unlike many automation tools, Windows MCP doesn't rely on any traditional computer vision techniques or specific fine-tuned models; it works with any LLMs, reducing complexity and setup time.
- **Rich Toolset for UI Automation**
Includes tools for basic keyboard, mouse operation and capturing window/UI state.
- **Lightweight & Open-Source**
Minimal dependencies and easy setup with full source code available under MIT license.
- **Customizable & Extendable**
Easily adapt or extend tools to suit your unique automation or AI integration needs.
- **Real-Time Interaction**
Typical latency between actions (e.g., from one mouse click to the next) ranges from **0.7 to 2.5 secs**, and may slightly vary based on the number of active applications and system load, also the inferencing speed of the llm.
### Prerequisites
- Python 3.13+
- Anthropic Claude Desktop app or other MCP Clients
- UV (Package Manager) from Astra, install with `pip install uv`
- DXT (Desktop Extension) from Antropic, install with `npm install -g @anthropic-ai/dxt`
- `English` as the default language in Windows or disable the `Launch-Tool` and `Resize-Tool` in the MCP Server for Windows with other languages.
## 🏁 Getting Started
### Gemini CLI
1. Navigate to `%USERPROFILE%/.gemini` in File Explorer and open `settings.json`.
2. Add the `windows-mcp` config in the `settings.json` and save it.
```json
{
"theme": "Default",
...
//MCP Server Config
"mcpServers": {
"windows-mcp": {
"command": "uv",
"args": [
"--directory",
"<path to the windows-mcp directory>",
"run",
"main.py"
]
}
}
}
```
3. Rerun Gemini CLI in terminal. Enjoy 🥳
### Claude Desktop
1. Clone the repository.
```shell
git clone https://github.com/CursorTouch/Windows-MCP.git
cd Windows-MCP
```
2. Build Desktop Extension `DXT`:
```shell
npx @anthropic-ai/dxt pack
```
3. Open Claude Desktop:
Go to Claude Desktop: Settings->Extensions->Install Extension (locate the `.dxt` file)-> Install
Finally Enjoy 🥳.
For additional Claude Desktop integration troubleshooting, see the [MCP documentation](https://modelcontextprotocol.io/quickstart/server#claude-for-desktop-integration-issues). The documentation includes helpful tips for checking logs and resolving common issues.
---
## 🛠️MCP Tools
Claude can access the following tools to interact with Windows:
- `Click-Tool`: Click on the screen at the given coordinates.
- `Type-Tool`: Type text on an element (optionally clears existing text).
- `Clipboard-Tool`: Copy or paste using the system clipboard.
- `Scroll-Tool`: Scroll vertically or horizontally on the window or specific regions.
- `Drag-Tool`: Drag from one point to another.
- `Move-Tool`: Move mouse pointer.
- `Shortcut-Tool`: Press keyboard shortcuts (`Ctrl+c`, `Alt+Tab`, etc).
- `Key-Tool`: Press a single key.
- `Wait-Tool`: Pause for a defined duration.
- `State-Tool`: Combined snapshot of default language, browser, active apps and interactive, textual and scrollable elements along with screenshot of the desktop.
- `Resize-Tool`: Used to change the window size or location of an app.
- `Launch-Tool`: To launch an application from the start menu.
- `Shell-Tool`: To execute PowerShell commands.
- `Scrape-Tool`: To scrape the entire webpage for information.
## Star History
[](https://www.star-history.com/#CursorTouch/Windows-MCP&Date)
## ⚠️Caution
This MCP interacts directly with your Windows operating system to perform actions. Use with caution and avoid deploying it in environments where such risks cannot be tolerated.
## 📝 Limitations
- Selecting specific sections of the text in a paragraph, as the MCP is relying on a11y tree. (⌛ Working on it.)
- `Type-Tool` is meant for typing text, not programming in IDE because of it types program as a whole in a file. (⌛ Working on it.)
## 🪪License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🤝Contributing
Contributions are welcome! Please see [CONTRIBUTING](CONTRIBUTING) for setup instructions and development guidelines.
Made with ❤️ by [Jeomon George](https://github.com/Jeomon)
## Citation
```bibtex
@software{
author = {George, Jeomon},
title = {Windows-MCP: Lightweight open-source project for integrating LLM agents with Windows},
year = {2024},
publisher = {GitHub},
url={https://github.com/CursorTouch/Windows-MCP}
}
```
Raw data
{
"_id": null,
"home_page": null,
"name": "iflow-mcp_windows-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.13",
"maintainer_email": null,
"keywords": "windows, mcp, ai, desktop, ai agent",
"author": null,
"author_email": "Jeomon George <jeogeoalukka@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/dd/ed/d17f10f91feeebe209d0242ebc853dc79dfdefed3af670785a27e2bd2ee2/iflow_mcp_windows_mcp-0.1.0.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n\n <h1>\ud83e\ude9f Windows-MCP</h1>\n\n <a href=\"https://github.com/CursorTouch/Windows-MCP/blob/main/LICENSE\">\n <img src=\"https://img.shields.io/badge/license-MIT-green\" alt=\"License\">\n </a>\n <img src=\"https://img.shields.io/badge/python-3.13%2B-blue\" alt=\"Python\">\n <img src=\"https://img.shields.io/badge/platform-Windows%207\u201311-blue\" alt=\"Platform: Windows 7 to 11\">\n <img src=\"https://img.shields.io/github/last-commit/CursorTouch/Windows-MCP\" alt=\"Last Commit\">\n <br>\n <a href=\"https://x.com/CursorTouch\">\n <img src=\"https://img.shields.io/badge/follow-%40CursorTouch-1DA1F2?logo=twitter&style=flat\" alt=\"Follow on Twitter\">\n </a>\n <a href=\"https://discord.com/invite/Aue9Yj2VzS\">\n <img src=\"https://img.shields.io/badge/Join%20on-Discord-5865F2?logo=discord&logoColor=white&style=flat\" alt=\"Join us on Discord\">\n </a>\n\n</div>\n\n<br>\n\n**Windows MCP** is a lightweight, open-source project that enables seamless integration between AI agents and the Windows operating system. Acting as an MCP server bridges the gap between LLMs and the Windows operating system, allowing agents to perform tasks such as **file navigation, application control, UI interaction, QA testing,** and more.\n\n## Updates\n\n- Try out \ud83e\ude9f[Windows-Use](https://github.com/CursorTouch/Windows-Use)!!, an agent built using Windows-MCP.\n- Windows-MCP is now featured as Desktop Extension in `Claude Desktop`.\n\n### Supported Operating Systems\n\n- Windows 7\n- Windows 8, 8.1\n- Windows 10\n- Windows 11 \n\n## \ud83c\udfa5 Demos\n\n<https://github.com/user-attachments/assets/d0e7ed1d-6189-4de6-838a-5ef8e1cad54e>\n\n<https://github.com/user-attachments/assets/d2b372dc-8d00-4d71-9677-4c64f5987485>\n\n## \u2728 Key Features\n\n- **Seamless Windows Integration** \n Interacts natively with Windows UI elements, opens apps, controls windows, simulates user input, and more.\n\n- **Use Any LLM (Vision Optional)**\n Unlike many automation tools, Windows MCP doesn't rely on any traditional computer vision techniques or specific fine-tuned models; it works with any LLMs, reducing complexity and setup time.\n\n- **Rich Toolset for UI Automation** \n Includes tools for basic keyboard, mouse operation and capturing window/UI state.\n\n- **Lightweight & Open-Source** \n Minimal dependencies and easy setup with full source code available under MIT license.\n\n- **Customizable & Extendable** \n Easily adapt or extend tools to suit your unique automation or AI integration needs.\n\n- **Real-Time Interaction** \n Typical latency between actions (e.g., from one mouse click to the next) ranges from **0.7 to 2.5 secs**, and may slightly vary based on the number of active applications and system load, also the inferencing speed of the llm.\n\n### Prerequisites\n\n- Python 3.13+\n- Anthropic Claude Desktop app or other MCP Clients\n- UV (Package Manager) from Astra, install with `pip install uv`\n- DXT (Desktop Extension) from Antropic, install with `npm install -g @anthropic-ai/dxt`\n- `English` as the default language in Windows or disable the `Launch-Tool` and `Resize-Tool` in the MCP Server for Windows with other languages.\n\n## \ud83c\udfc1 Getting Started\n\n### Gemini CLI\n\n1. Navigate to `%USERPROFILE%/.gemini` in File Explorer and open `settings.json`.\n\n2. Add the `windows-mcp` config in the `settings.json` and save it.\n\n```json\n{\n \"theme\": \"Default\",\n ...\n//MCP Server Config\n \"mcpServers\": {\n \"windows-mcp\": {\n \"command\": \"uv\",\n \"args\": [\n \"--directory\",\n \"<path to the windows-mcp directory>\",\n \"run\",\n \"main.py\"\n ]\n }\n }\n}\n```\n\n3. Rerun Gemini CLI in terminal. Enjoy \ud83e\udd73\n\n### Claude Desktop\n\n1. Clone the repository.\n\n```shell\ngit clone https://github.com/CursorTouch/Windows-MCP.git\ncd Windows-MCP\n```\n\n2. Build Desktop Extension `DXT`:\n\n```shell\nnpx @anthropic-ai/dxt pack\n```\n\n3. Open Claude Desktop:\n\nGo to Claude Desktop: Settings->Extensions->Install Extension (locate the `.dxt` file)-> Install\n\nFinally Enjoy \ud83e\udd73.\n\nFor additional Claude Desktop integration troubleshooting, see the [MCP documentation](https://modelcontextprotocol.io/quickstart/server#claude-for-desktop-integration-issues). The documentation includes helpful tips for checking logs and resolving common issues.\n\n---\n\n## \ud83d\udee0\ufe0fMCP Tools\n\nClaude can access the following tools to interact with Windows:\n\n- `Click-Tool`: Click on the screen at the given coordinates.\n- `Type-Tool`: Type text on an element (optionally clears existing text).\n- `Clipboard-Tool`: Copy or paste using the system clipboard.\n- `Scroll-Tool`: Scroll vertically or horizontally on the window or specific regions.\n- `Drag-Tool`: Drag from one point to another.\n- `Move-Tool`: Move mouse pointer.\n- `Shortcut-Tool`: Press keyboard shortcuts (`Ctrl+c`, `Alt+Tab`, etc).\n- `Key-Tool`: Press a single key.\n- `Wait-Tool`: Pause for a defined duration.\n- `State-Tool`: Combined snapshot of default language, browser, active apps and interactive, textual and scrollable elements along with screenshot of the desktop.\n- `Resize-Tool`: Used to change the window size or location of an app.\n- `Launch-Tool`: To launch an application from the start menu.\n- `Shell-Tool`: To execute PowerShell commands.\n- `Scrape-Tool`: To scrape the entire webpage for information.\n\n## Star History\n\n[](https://www.star-history.com/#CursorTouch/Windows-MCP&Date)\n\n## \u26a0\ufe0fCaution\n\nThis MCP interacts directly with your Windows operating system to perform actions. Use with caution and avoid deploying it in environments where such risks cannot be tolerated.\n\n## \ud83d\udcdd Limitations\n\n- Selecting specific sections of the text in a paragraph, as the MCP is relying on a11y tree. (\u231b Working on it.)\n- `Type-Tool` is meant for typing text, not programming in IDE because of it types program as a whole in a file. (\u231b Working on it.)\n\n## \ud83e\udeaaLicense\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## \ud83e\udd1dContributing\n\nContributions are welcome! Please see [CONTRIBUTING](CONTRIBUTING) for setup instructions and development guidelines.\n\nMade with \u2764\ufe0f by [Jeomon George](https://github.com/Jeomon)\n\n## Citation\n\n```bibtex\n@software{\n author = {George, Jeomon},\n title = {Windows-MCP: Lightweight open-source project for integrating LLM agents with Windows},\n year = {2024},\n publisher = {GitHub},\n url={https://github.com/CursorTouch/Windows-MCP}\n}\n```\n",
"bugtrack_url": null,
"license": "MIT License Copyright (c) 2025 JEOMON GEORGE Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.",
"summary": "Lightweight MCP Server for interacting with Windows Operating System.",
"version": "0.1.0",
"project_urls": {
"homepage": "https://github.com/CursorTouch"
},
"split_keywords": [
"windows",
" mcp",
" ai",
" desktop",
" ai agent"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "75c8695d3c02347ed9321899846edeab9558f12777125ce80297dc8677e2a2b4",
"md5": "fc36ec9fa40c80f8ff883ef345f201cd",
"sha256": "e13cceaba0e255fabdec63a36823e198b5cacc85661f9c4915890f4e3d877d25"
},
"downloads": -1,
"filename": "iflow_mcp_windows_mcp-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "fc36ec9fa40c80f8ff883ef345f201cd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.13",
"size": 18366,
"upload_time": "2025-08-14T07:24:01",
"upload_time_iso_8601": "2025-08-14T07:24:01.854723Z",
"url": "https://files.pythonhosted.org/packages/75/c8/695d3c02347ed9321899846edeab9558f12777125ce80297dc8677e2a2b4/iflow_mcp_windows_mcp-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "ddedd17f10f91feeebe209d0242ebc853dc79dfdefed3af670785a27e2bd2ee2",
"md5": "f727bd50f5ba31c7cc610d1b61d0b529",
"sha256": "615f586916c4f8199df7830bd5cf8e9c36855eb67a1fe6d11491542784b78cbf"
},
"downloads": -1,
"filename": "iflow_mcp_windows_mcp-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "f727bd50f5ba31c7cc610d1b61d0b529",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.13",
"size": 15464,
"upload_time": "2025-08-14T07:24:03",
"upload_time_iso_8601": "2025-08-14T07:24:03.845693Z",
"url": "https://files.pythonhosted.org/packages/dd/ed/d17f10f91feeebe209d0242ebc853dc79dfdefed3af670785a27e2bd2ee2/iflow_mcp_windows_mcp-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-14 07:24:03",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "iflow-mcp_windows-mcp"
}
