cua-mcp-server is a MCP server for the Computer-Use Agent (CUA), allowing you to run CUA through Claude Desktop or other MCP clients.
Get started with Agent
Installation
Install the package from PyPI:
This will install:
- The MCP server
- CUA agent and computer dependencies
- An executable
cua-mcp-serverscript in your PATH
Easy Setup Script
If you want to simplify installation, you can use this one-liner to download and run the installation script:
This script will:
- Create the ~/.cua directory if it doesn't exist
- Generate a startup script at ~/.cua/start_mcp_server.sh
- Make the script executable
- The startup script automatically manages Python virtual environments and installs/updates the cua-mcp-server package
You can then use the script in your MCP configuration like this:
Claude Desktop Integration
To use with Claude Desktop, add an entry to your Claude Desktop configuration (
claude_desktop_config.json, typically found in ~/.config/claude-desktop/):For more information on MCP with Claude Desktop, see the official MCP User Guide.
Cursor Integration
To use with Cursor, add an MCP configuration file in one of these locations:
- Project-specific: Create
.cursor/mcp.jsonin your project directory
- Global: Create
~/.cursor/mcp.jsonin your home directory
After configuration, you can simply tell Cursor's Agent to perform computer tasks by explicitly mentioning the CUA agent, such as "Use the computer control tools to open Safari."
For more information on MCP with Cursor, see the official Cursor MCP documentation.
First-time Usage Notes
API Keys: Ensure you have valid API keys:
- Add your Anthropic API key, or other model provider API key in the Claude Desktop config (as shown above)
- Or set it as an environment variable in your shell profile
Configuration
The server is configured using environment variables (can be set in the Claude Desktop config):
[object Object] | [object Object] | [object Object] |
[object Object] | [object Object] | [object Object] |
[object Object] | [object Object] | [object Object] |
[object Object] | [object Object] | [object Object] |
[object Object] | [object Object] | [object Object] |
[object Object] | [object Object] | [object Object] |
Available Tools
The MCP server exposes the following tools to Claude:
run_cua_task- Run a single Computer-Use Agent task with the given instruction
run_multi_cua_tasks- Run multiple tasks in sequence
Usage
Once configured, you can simply ask Claude to perform computer tasks:
- "Open Chrome and go to github.com"
- "Create a folder called 'Projects' on my desktop"
- "Find all PDFs in my Downloads folder"
- "Take a screenshot and highlight the error message"
Claude will automatically use your CUA agent to perform these tasks.
cua-mcp-server is a MCP server for the Computer-Use Agent (CUA), allowing you to run CUA through Claude Desktop or other MCP clients.
Get started with Agent
Installation
Install the package from PyPI:
This will install:
- The MCP server
- CUA agent and computer dependencies
- An executable
cua-mcp-serverscript in your PATH
Easy Setup Script
If you want to simplify installation, you can use this one-liner to download and run the installation script:
This script will:
- Create the ~/.cua directory if it doesn't exist
- Generate a startup script at ~/.cua/start_mcp_server.sh
- Make the script executable
- The startup script automatically manages Python virtual environments and installs/updates the cua-mcp-server package
You can then use the script in your MCP configuration like this:
Claude Desktop Integration
To use with Claude Desktop, add an entry to your Claude Desktop configuration (
claude_desktop_config.json, typically found in ~/.config/claude-desktop/):For more information on MCP with Claude Desktop, see the official MCP User Guide.
Cursor Integration
To use with Cursor, add an MCP configuration file in one of these locations:
- Project-specific: Create
.cursor/mcp.jsonin your project directory
- Global: Create
~/.cursor/mcp.jsonin your home directory
After configuration, you can simply tell Cursor's Agent to perform computer tasks by explicitly mentioning the CUA agent, such as "Use the computer control tools to open Safari."
For more information on MCP with Cursor, see the official Cursor MCP documentation.
First-time Usage Notes
API Keys: Ensure you have valid API keys:
- Add your Anthropic API key, or other model provider API key in the Claude Desktop config (as shown above)
- Or set it as an environment variable in your shell profile
Configuration
The server is configured using environment variables (can be set in the Claude Desktop config):
[object Object] | [object Object] | [object Object] |
[object Object] | [object Object] | [object Object] |
[object Object] | [object Object] | [object Object] |
[object Object] | [object Object] | [object Object] |
[object Object] | [object Object] | [object Object] |
[object Object] | [object Object] | [object Object] |
Available Tools
The MCP server exposes the following tools to Claude:
run_cua_task- Run a single Computer-Use Agent task with the given instruction
run_multi_cua_tasks- Run multiple tasks in sequence
Usage
Once configured, you can simply ask Claude to perform computer tasks:
- "Open Chrome and go to github.com"
- "Create a folder called 'Projects' on my desktop"
- "Find all PDFs in my Downloads folder"
- "Take a screenshot and highlight the error message"
Claude will automatically use your CUA agent to perform these tasks.