# NexusWindows

> NexusWindows is an open-source MCP server for productivity. Background Windows desktop control for Claude, Codex and Antigravity, MIT licensed. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Windows, CLI
- **Website:** https://julienpiron.fr/nexuswindows/
- **Repository:** https://github.com/pironjulien/nexuswindows
- **MCP Registry name:** io.github.pironjulien/nexus-windows
- **Categories:** productivity, developer tools
- **Listing updated:** 2026-11-14

## About

The pitch is that an agent can work a Windows app while you keep using your mouse, keyboard and foreground window. It reads windows through UI Automation and Win32 messages, then re-reads the result of each action, so a step it cannot verify is reported as unknown rather than success. A real mouse is a last resort and only with your permission.

The engine is a single native C# (.NET 10) program for Windows 10 and 11 on x64 or ARM64, with no Python, Node.js or .NET runtime to install. Three profiles share it. The Claude profile is a local MCP server for Claude Code and Claude Desktop with seven tools, the Codex profile has five and runs as a plugin, and the Antigravity profile has five, aimed at Gemini models.

Irreversible actions such as paying, sending or permanent deletion are held until you confirm. The site reports its own comparison against Cua Driver 0.44.0 with a covered window: 102 real effects out of 116 attempts against 50, with no false success against 16.

## Features

- **Background-first control:** Acts on windows without taking focus from you.
- **Verified effects:** Each step is read back and marked verified, already true, sent unread or failed.
- **Three agent profiles:** Separate tool sets for Claude, Codex and Antigravity on one engine.
- **Confirmation for outward actions:** Send, pay, publish and delete wait for your yes.
- **Window capture:** Captures covered windows and uses OCR when accessibility data is missing.
- **Replayable routines:** Verified routines can be replayed by name and rechecked each step.

## Good for

- Fill in a desktop form while you keep working in another window
- Drive Windows Settings or the taskbar from an agent
- Run a repeatable routine in a legacy Win32 or WPF app
- Give Team or Enterprise Claude plans a local computer-use server

## Install

### Claude Code (Terminal)

```sh
claude mcp add nexus-windows -- npx -y https://github.com/pironjulien/NexusWindows/releases/download/v3.17.12/nexus-windows-claude.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "nexus-windows": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/pironjulien/NexusWindows/releases/download/v3.17.12/nexus-windows-claude.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "nexus-windows": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/pironjulien/NexusWindows/releases/download/v3.17.12/nexus-windows-claude.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "nexus-windows": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/pironjulien/NexusWindows/releases/download/v3.17.12/nexus-windows-claude.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "nexus-windows": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/pironjulien/NexusWindows/releases/download/v3.17.12/nexus-windows-claude.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "nexus-windows": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/pironjulien/NexusWindows/releases/download/v3.17.12/nexus-windows-claude.mcpb"
      ]
    }
  }
}
```

## Tools

- `windows`: Lists windows.
- `look`: Numbers the elements of a window without bringing it to the front.
- `act`: Runs a batch of steps and reports each outcome.
- `launch`: Starts an application.
- `window`: Manages a window.
- `notifications`: Reads notifications.
- `logs`: Returns logs.

## FAQ

### Which Windows versions work?

Windows 10 and 11, on x64 or ARM64.

### Which tools does the Claude profile have?

windows, look, act, launch, window, notifications and logs.

### What licence is it under?

MIT.

### Does it need extra runtimes?

No. It is one self-contained native program.

### Is NexusWindows free?

Yes. NexusWindows is open source, so you can use and self-host it for free.

### How do I add NexusWindows to Claude Code?

Run this command in your terminal: claude mcp add nexus-windows -- npx -y https://github.com/pironjulien/NexusWindows/releases/download/v3.17.12/nexus-windows-claude.mcpb

### What are the best alternatives to NexusWindows?

The closest alternatives to NexusWindows are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/nexuswindows
