GNOME Desktop MCP

Desktop automation for GNOME Wayland via MCP. Take screenshots, manage windows, and inject keyboard/mouse input from AI assistants like Claude Code.

Claude Code ──MCP──▶ gnome-desktop-mcp (Python) ──D-Bus──▶ GNOME Shell Extension

GNOME Wayland blocks external processes from taking screenshots or injecting input. This extension runsinsidethe compositor, bypassing those restrictions, and exposes a D-Bus API. The MCP server bridges that API to any MCP-compatible client.

- 30 MCP tools: screenshots, window management, input injection, workspace control
- Privacy indicator: top bar icon shows connection status (red = active, grey = idle)
- Consent dialog: first-use confirmation before enabling automation
- Access gating: master kill switch to disable all automation instantly

- GNOME Shell 45-49 (Wayland)
- Python 3.12+

git clone https://github.com/sbuysse/gnome-mcp.git cd gnome-mcp ./install.sh

Then log out and back in (required for Wayland), and enable:

gnome-extensions enable desktop-automation@gnomemcp.github.io

{ "mcpServers": { "desktop-automation": { "command": "gnome-desktop-mcp" } } }

- Top bar indicatorshows when automation is active
- Toggle switchto disable all automation instantly
- Activity logtracks last 20 method calls (name + timestamp only, no data)
- D-Bus access gating: all methods blocked when disabled
- Session bus trust model: any local user process can call the API (consistent with GNOME's security model)

The GNOME Shell extension (desktop-automation@gnomemcp.github.io) runs inside the Wayland compositor. It exportsio.github.gnomemcp.DesktopAutomationon the session D-Bus with privileged access to:

- Shell.Screenshot— silent screenshots (no permission dialog)
- Meta.Window— window management
- Clutter.VirtualInputDevice— keyboard/mouse injection

The Python MCP server (gnome-desktop-mcp) translates MCP tool calls into D-Bus method calls viadasbus.

# Install in development mode pip install -e mcp-server[dev] # Run tests python -m pytest tests/ -v # Watch extension logs journalctl /usr/bin/gnome-shell -f # Test D-Bus directly gdbus call --session --dest org.gnome.Shell \ --object-path /io/github/gnomemcp/DesktopAutomation \ --method io.github.gnomemcp.DesktopAutomation.Ping

Let Claude control your Mac — 12 typed tools for windows, menus, keyboard, clipboard, browser tabs

A local office automation assistant for file system operations, system command execution, and browser control.

A TypeScript server for automation and integration, featuring Microsoft OAuth, browser control, and basic utilities.

Plugin-based MCP server that gives AI agents access to web applications through the user's authenticated browser session. Chrome extension with 100+ plugins for Slack, Discord, GitHub, Reddit, and more.

Hosted remote MCP server with managed OAuth for a growing list of 15+ toolkits, including Google Workspace, Last.fm, MusicBrainz, Fitbit, Oura, Kalshi, and Polymarket.

Zo is your personal vibe server in the cloud with 50+ tools and integrations. Add texting, email, calendar, research and more to your harness easily.

Agentic pipeline that transforms ideas to revenue — for solo founders and bootstrappers.

Mushrooms is an MCP (Model Context Protocol) platform that connects AI assistants like ChatGPT, Claude, Cursor, and Gemini to 1,842+ apps, enabling them to perform real-world actions such as reading emails, creating tasks, updating CRMs, sending messages, and automating workflows—all through a secure, permission-controlled MCP server.

⚡ The Complete X/Twitter Automation Toolkit — Scrapers, MCP server for AI agents (Claude/GPT), CLI, browser scripts. No API fees. Open source.

Connect AI clients to Cal.com scheduling through the Model Context Protocol using the hosted server at mcp.cal.com or a local instance.