Deskwright MCP Server
by tristanmuzzuio.github.tristanmuzzu/deskwrightv0.1.1
Agents use real GNOME/Wayland apps: on your screen, or an invisible second desktop you never see
context tax
queued
security
queued
cold start
queued
freshness
Active2d ago
Install Deskwright MCP server
Install in Claude Code
claude mcp add deskwright -- uvx deskwrightInstall in Cursor
{
"mcpServers": {
"deskwright": {
"command": "uvx",
"args": [
"deskwright"
]
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"deskwright": {
"command": "uvx",
"args": [
"deskwright"
]
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"deskwright": {
"type": "stdio",
"command": "uvx",
"args": [
"deskwright"
]
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"deskwright": {
"command": "uvx",
"args": [
"deskwright"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| DESKWRIGHT_SESSION | — | — | Which desktop to drive: 'primary' (the screen you are looking at), 'headless' for an invisible virtual-monitor session, or 'headless:<name>' to pick one of several. |
| DESKWRIGHT_INPUT_BACKEND | — | — | Force the input path: 'mutter' for GNOME's org.gnome.Mutter.RemoteDesktop (no consent dialog), 'portal' for org.freedesktop.portal.RemoteDesktop (one consent, then persisted). Auto-selected when unset. |
Freshness
Active — last maintenance signal 2d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-10-07 · 2d ago · GitHub
Latest release
2026-09-01 · 38d ago · GitHub · v0.1.1
Package published
no data · npm/PyPI
Registry entry updated
2026-09-01 · 38d ago · official registry · v0.1.1
FAQ
›How do I install the Deskwright MCP server in Claude Code?
Run: claude mcp add deskwright -- uvx deskwright. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Deskwright require an API key?
No required environment variables are declared in its published metadata.
›Can I use Deskwright as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Deskwright in the official MCP registry?
Yes, as io.github.tristanmuzzu/deskwright.