{"id":28185048,"url":"https://github.com/jeomon/windows-mcp","last_synced_at":"2025-05-16T06:11:13.681Z","repository":{"id":292968041,"uuid":"982517950","full_name":"Jeomon/Windows-MCP","owner":"Jeomon","description":"Lightweight MCP Server for interacting with Windows Operating System.","archived":false,"fork":false,"pushed_at":"2025-05-15T08:14:42.000Z","size":8315,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-15T09:27:12.425Z","etag":null,"topics":["desktop","mcp","mcp-server","tools","windows","windows-10","windows-11"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Jeomon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-13T02:27:53.000Z","updated_at":"2025-05-15T08:14:46.000Z","dependencies_parsed_at":"2025-05-15T09:37:35.494Z","dependency_job_id":null,"html_url":"https://github.com/Jeomon/Windows-MCP","commit_stats":null,"previous_names":["computer-agent/windows-mcp","jeomon/windows-mcp"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jeomon%2FWindows-MCP","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jeomon%2FWindows-MCP/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jeomon%2FWindows-MCP/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jeomon%2FWindows-MCP/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Jeomon","download_url":"https://codeload.github.com/Jeomon/Windows-MCP/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254478189,"owners_count":22077677,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["desktop","mcp","mcp-server","tools","windows","windows-10","windows-11"],"created_at":"2025-05-16T06:11:07.165Z","updated_at":"2025-05-16T06:11:13.669Z","avatar_url":"https://github.com/Jeomon.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n  \u003ch1\u003e🪟 Windows-MCP\u003c/h1\u003e\n\n  \u003ca href=\"https://github.com/Computer-Agent/Windows-MCP/blob/main/LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/license-MIT-green\" alt=\"License\"\u003e\n  \u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/python-3.12%2B-blue\" alt=\"Python\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/platform-Windows%2010%20%7C%2011-blue\" alt=\"Platform\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/last-commit/Computer-Agent/Windows-MCP\" alt=\"Last Commit\"\u003e\n\n  \u003cbr\u003e\n\n  \u003ca href=\"https://x.com/computeraiagent\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/follow-%40computeraiagent-1DA1F2?logo=twitter\u0026style=flat\" alt=\"Follow on Twitter\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://discord.com/invite/Aue9Yj2VzS\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Join%20on-Discord-5865F2?logo=discord\u0026logoColor=white\u0026style=flat\" alt=\"Join us on Discord\"\u003e\n  \u003c/a\u003e\n\n\u003c/div\u003e\n\n\u003cbr\u003e\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\u003chttps://github.com/user-attachments/assets/7149561b-3018-49ca-be82-035b3f054c07\u003e\n\n## ✨ 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 \u0026 Open-Source**  \n  Minimal dependencies and easy setup with full source code available under MIT license.\n\n- **Customizable \u0026 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 **4 to 8 secs**, and may slightly vary based on the number of active applications and system load.\n\n### Supported Operating Systems\n\n- Windows 10\n- Windows 11  \n\n## Installation\n\n### Prerequisites\n\n- Python 3.12+\n- Anthropic Claude Desktop app or other MCP Clients\n- UV (Python package manager), install with `pip install uv`\n\n## 🏁 Getting Started\n\n1. Clone the repository.\n\n```shell\ngit clone https://github.com/Jeomon/Windows-MCP.git\ncd Windows-MCP\n```\n\n2. Install dependencies:\n\n```shell\nuv pip install -r pyproject.toml\n```\n\n3. Connect to the MCP server\n\nCopy the below JSON with the appropriate {{PATH}} values:\n\n```json\n{\n   \"mcpServers\": {\n      \"windows-mcp\": {\n         \"command\": \"{{PATH_TO_UV}}\",\n         \"args\": [\n            \"--directory\",\n            \"{{PATH_TO_SRC}}/Windows-MCP\",\n            \"run\",\n            \"server.py\"\n         ]\n      }\n   }\n}\n```\n\nFor Claude, save this as claude_desktop_config.json in your Claude Desktop configuration directory at:\n\n```shell\n%APPDATA%/Claude/claude_desktop_config.json\n```\n\n4. Restart Claude Desktop\n\nOpen Claude Desktop, and you should now see Windows-MCP as an available integration.\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## 🛠️MCP 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 up/down.\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 active apps and interactive UI elements.\n- `Screenshot-Tool`: Capture a screenshot of the desktop.\n- `Launch-Tool`: To launch an application from the start menu.\n- `Shell-Tool`: To execute PowerShell commands.\n\n## ⚠️Caution\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## 🪪License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🤝Contributing\n\nContributions are welcome! Please see [CONTRIBUTING](CONTRIBUTING) for setup instructions and development guidelines.\n\nMade with ❤️ by [Jeomon George](https://github.com/Jeomon)\n\n## Citation\n\n```bibtex\n@misc{\n  author       = {George, Jeomon},\n  title        = {Windows-MCP},\n  year         = {2024},\n  publisher    = {GitHub},\n  howpublished = {\\url{https://github.com/Jeomon/Windows-MCP}},\n  note         = {Lightweight open-source project for integrating LLM agents with Windows}\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeomon%2Fwindows-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjeomon%2Fwindows-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeomon%2Fwindows-mcp/lists"}