winget-mcp
A Gemini CLI extension for the Windows Package Manager (WinGet) MCP server.
Open source Open in the app JSON README (API)
About
A Gemini CLI extension for the Windows Package Manager (WinGet) MCP server.
Details
- Kind
- Plugins
- Topic
- Developer tools
- Publisher
- zhanziyuan
- Origin
- gemini
- Category
- ferramentas
- Version
- 1.0.2
- Stars
- 5
- Last push
- 2026-01-28T09:44:00Z
- Repository state
- ativo
- License
- GPL-3.0
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
zhanziyuan/winget-mcp
README
# WinGet MCP
<p align="right">
<b>English</b> | <a href="./README_zh.md">简体中文</a>
</p>
[](https://github.com/ZhanZiyuan/winget-mcp/commits/main/)
[](https://github.com/ZhanZiyuan/winget-mcp/blob/main/LICENSE)
[](https://github.com/ZhanZiyuan/winget-mcp/releases)
This extension integrates the **Windows Package Manager (WinGet)** with the Gemini CLI using the Model Context Protocol (MCP).
It allows you to search for software packages and generate installation commands directly within your conversation with Gemini.
## Features
- **Package Discovery**: Search for packages in the WinGet repository using the `/winget:find` command or natural language.
- **Installation Helper**: Generate installation commands with safety warnings using `/winget:install`.
- **Environment Setup**: specialized "Package Manager Expert" skill that helps you architect and install full development environments (e.g., "Setup a Python dev environment").
- **Language Aware**: The extension detects your language (English/Chinese) and adapts its output accordingly.
## Prerequisites
- **OS**: Windows 10 (1809+) or Windows 11.
- **Software**:
- [Gemini CLI](https://geminicli.com) installed.
- [App Installer (WinGet)](https://apps.microsoft.com/detail/9nblggh4nns1) installed and up to date.
## Installation & Setup
- Open a command prompt and enter the `winget mcp` command. The result displays the JSON configuration fragment that shows the path to the `WindowsPackageManagerMCPServer.exe` file.
```bash
winget mcp
```
If the following error occurs: **Unrecognized command: 'mcp'**
Verify that the App Installer application is up to date on the device.
This can be verified in the Store application.
- **Configure the Extension**:
Open the `gemini-extension.json` file in this folder.
Locate the `mcpServers.winget-mcp.command` field and replace the existing path with the one you found in the previous step.
```json
"mcpServers": {
"winget-mcp": {
"type": "stdio",
"command": "C:\\Users\\<username>\\AppData\\Local\\Microsoft\\WindowsApps\\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\\WindowsPackageManagerMCPServer.exe",
"args": [],
"env": {}
}
}
```
**Note:** Ensure you double the backslashes (`\\`) in the JSON file path.
- Once you have updated the configuration file, link the extension to Gemini CLI:
```bash
gemini extensions link .
```
Or install the extension using the following command:
```bash
gemini extensions install https://github.com/ZhanZiyuan/winget-mcp
```
After running this command, restart your Gemini CLI session.
## Usage
### Commands
- **Find a Package**:
```bash
/winget:find "Visual Studio Code"
```
*Or just ask:* "Find a pdf reader for me."
- **Install a Package**:
```bash
/winget:install "Microsoft.VisualStudioCode"
```
*Or just ask:* "How do I install Chrome?"
### Skills
This extension includes a **Package Manager Expert** skill.
It activates automatically when you have complex requests.
- **Example**: "I want to setup a complete web development environment with Node.js, VS Code, and Git."
- *The agent will break this down, verify package IDs for each tool, and provide a comprehensive installation plan.*
## License
This project is licensed under the GPLv3 License - see the [LICENSE](./LICENSE) file for details.
---
*Based on the [Getting started with Gemini CLI extensions](https://geminicli.com/docs/extensions/getting-started-extensions/) and [Use the Windows Package Manager MCP Server for package management with AI agents](https://learn.microsoft.com/en-us/windows/package-manager/winget/mcp-server).*