Clawdcursor
OS-agnostic, model-agnostic desktop automation server. Gives any AI agent eyes, hands, and ground-truth verification on Windows, macOS, and Linux.
What is Clawdcursor?
Clawdcursor is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to os-agnostic, model-agnostic desktop automation server. gives any ai agent eyes, hands, and ground-truth verification on windows, macos, and linux.
OS-agnostic, model-agnostic desktop automation server. Gives any AI agent eyes, hands, and ground-truth verification on Windows, macOS, and Linux.
This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- OS-agnostic, model-agnostic desktop automation server. Gives
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx clawdcursorConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Clawdcursor
ClawdCursor is an OS-agnostic, model-agnostic desktop automation MCP server that gives AI agents eyes, hands, and ground-truth verification across Windows, macOS, and Linux. It exposes seven compound tools covering screenshots, mouse and keyboard control, accessibility tree navigation, window management, clipboard, OCR, Chrome DevTools Protocol integration, and a batch action tool — approximately 100 combined actions in total. It operates fully locally with no cloud telemetry, requires no API keys, and integrates with Claude Code, Cursor, Windsurf, Zed, and any other MCP-compatible client via stdio.
Prerequisites
- Node.js with npm installed (for `npm i -g clawdcursor`)
- macOS: Accessibility permission and optionally Screen Recording permission granted to your terminal or MCP client
- Linux: tesseract-ocr, python3-gi, gir1.2-atspi-2.0 installed; plus ydotool or wtype for Wayland
- Windows: no additional dependencies required
- An MCP-compatible client such as Claude Code, Cursor, or Windsurf
Install ClawdCursor globally
Install the clawdcursor npm package globally. This makes the clawdcursor binary available system-wide.
npm i -g clawdcursorAccept the desktop control consent prompt
Run the consent command to accept the terms for granting an AI agent control over your desktop. This is a one-time step.
clawdcursor consent --acceptGrant permissions on macOS
On macOS, run the grant command which opens System Settings to the correct Privacy & Security panels. Accessibility is required; Screen Recording is optional for screenshots.
clawdcursor grantInstall Linux dependencies if needed
On Linux with X11, install the required accessibility and OCR packages. On Wayland, also install ydotool or wtype for input simulation.
sudo apt install tesseract-ocr python3-gi gir1.2-atspi-2.0
# Wayland only:
sudo apt install ydotoolAdd to your MCP client configuration
Add ClawdCursor to your MCP client's settings. The --compact flag reduces output size for faster agent interactions.
{
"mcpServers": {
"clawdcursor": {
"command": "clawdcursor",
"args": ["mcp", "--compact"]
}
}
}Verify the setup
Run the doctor command to verify permissions, check that all required system dependencies are present, and confirm the server is ready.
clawdcursor doctor
clawdcursor statusClawdcursor Examples
Client configuration
Configuration for Claude Code or any MCP client using stdio transport. The server starts on demand when the client connects.
{
"mcpServers": {
"clawdcursor": {
"command": "clawdcursor",
"args": ["mcp", "--compact"]
}
}
}Prompts to try
Example prompts that use ClawdCursor's computer, accessibility, window, and browser automation tools.
- "Take a screenshot and describe what is currently on my screen"
- "Open the Calculator app and compute 1234 times 5678"
- "Click on the search bar in the active window and type 'quarterly report'"
- "Open Chrome, navigate to https://github.com, and take a screenshot of the page"
- "Read the text in the notification that just appeared using OCR"
- "Copy the selected text to clipboard and tell me what it says"Troubleshooting Clawdcursor
macOS: screenshots are black or accessibility actions fail
Run `clawdcursor grant` and then manually enable ClawdCursor (or your terminal emulator) under System Settings → Privacy & Security → Accessibility. For screenshots, also enable Screen Recording. Restart the MCP client after granting permissions.
macOS: native Swift helper fails to build or is missing
If Swift toolchain was not present when clawdcursor was installed, manually build the helper: `cd "$(npm root -g)/clawdcursor" && bash native/build.sh`. Ensure Xcode Command Line Tools are installed first with `xcode-select --install`.
Linux: input simulation does not work on Wayland
Install either ydotool (`sudo apt install ydotool`) or wtype for Wayland input injection. X11 users should ensure the DISPLAY environment variable is set and xdotool-compatible tooling is available.
Frequently Asked Questions about Clawdcursor
What is Clawdcursor?
Clawdcursor is a Model Context Protocol (MCP) server that os-agnostic, model-agnostic desktop automation server. gives any ai agent eyes, hands, and ground-truth verification on windows, macos, and linux. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Clawdcursor?
Follow the installation instructions on the Clawdcursor GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Clawdcursor?
Clawdcursor works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Clawdcursor free to use?
Yes, Clawdcursor is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Clawdcursor Alternatives — Similar Browser Automation Servers
Looking for alternatives to Clawdcursor? Here are other popular browser automation servers you can use with Claude, Cursor, and VS Code.
Chrome DevTools MCP
★ 40.6kAI-powered Chrome automation server with natural language element detection. Control Chrome browser through MCP protocol for testing, debugging, and performance analysis. Features 91% accuracy in element location, works with free AI models, and suppo
UI TARS Desktop
★ 34.9k📇 🏠 - Browser automation capabilities using Puppeteer, both support local and remote browser connection.
Playwright
★ 32.8kA production-ready browser automation server that enables AI assistants to interact with web pages using tools for navigation, element interaction, and data extraction. It features a built-in Inspector UI and robust crash recovery for reliable automa
Page Agent
★ 18.0kJavaScript in-page GUI agent. Control web interfaces with natural language.
Chrome
★ 11.7kAn extension-based MCP server that enables AI assistants to control your browser, leveraging existing sessions and login states for automation and content analysis. It provides over 20 tools for semantic tab search, interactive element manipulation,
LAMDA
★ 7.8kThe most powerful Android RPA agent framework, next generation mobile automation.
Browse More Browser Automation MCP Servers
Explore all browser automation servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Clawdcursor in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Clawdcursor?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.