web-automation-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@web-automation-mcp Ask ChatGPT: What is the capital of France?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Web Automation MCP Server
An MCP (Model Context Protocol) server that enables Claude Code CLI to interact with Cloud Desktop, ChatGPT, and Gemini web interfaces through browser automation.
Features
Multi-Service Support: Interact with Cloud Desktop, ChatGPT, and Gemini
Browser Automation: Uses Playwright for reliable web automation
Session Persistence: Maintains browser sessions across requests
Response Extraction: Automatically extracts and returns responses
Conversation Management: Clear conversation history when needed
Related MCP server: Glance
Installation
Clone the repository:
cd ~/web-automation-mcpInstall dependencies:
npm installBuild the project:
npm run buildConfiguration
Add the server to your Claude MCP settings (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"web-automation": {
"command": "node",
"args": ["/Users/YOUR_USERNAME/web-automation-mcp/dist/index.js"]
}
}
}Usage
Natural Language Support
The MCP server now supports natural language queries through the web_automation_query tool:
# Ask ChatGPT a question
"Ask ChatGPT: What is quantum computing?"
# Send to Gemini
"Send to Gemini: Explain machine learning"
# Clear conversation
"Clear ChatGPT conversation"
# Get latest response
"Get the latest response from Gemini"
# Browser control
"Initialize browser in visible mode"
"Close browser"Available Tools
web_automation_query - Process natural language queries
query: string - Natural language description of what you want to do
initialize_browser - Initialize the browser
headless: boolean (default: false) - Run in headless mode
send_to_service - Send input to a service and get response
service: "clouddesktop" | "chatgpt" | "gemini"content: string - The message to send
get_latest_response - Get the latest response from a service
service: "clouddesktop" | "chatgpt" | "gemini"
clear_conversation - Clear conversation history
service: "clouddesktop" | "chatgpt" | "gemini"
cleanup_browser - Close all browser windows
Example Usage in Claude Code
Natural language examples:
# Ask ChatGPT
Use web_automation_query with query: "Ask ChatGPT about the history of computing"
# Send to Gemini
Use web_automation_query with query: "Send to Gemini: write a Python function to sort a list"
# Clear conversation
Use web_automation_query with query: "Clear ChatGPT conversation"Direct tool usage:
# Initialize browser (visible mode)
Use the initialize_browser tool with headless: false
# Send a message to ChatGPT
Use the send_to_service tool with service: "chatgpt" and content: "What is the capital of France?"
# Clean up when done
Use the cleanup_browser toolImportant Notes
Manual Login Required: You must manually log in to each service in the browser window the first time
Service URLs: Update the URLs in the handler files if they change:
src/handlers/cloudDesktop.ts- Update Cloud Desktop URLsrc/handlers/chatgpt.ts- ChatGPT URLsrc/handlers/gemini.ts- Gemini URL
Selectors: The CSS selectors in handlers may need updates if the services change their UI
Development
To run in development mode:
npm run devTo modify service handlers, edit the files in src/handlers/.
Troubleshooting
Login Required Error: Open the browser in non-headless mode and log in manually
Selector Not Found: The service UI may have changed - update selectors in the handler
Timeout Errors: Increase timeout values in the handlers for slower connections
License
MIT
Available Tools
6 toolscleanup_browserA
Close all browser windows and clean up resources
Inputs: no named parameters.
clear_conversationB
Clear the conversation history in a service
Inputs: service (required).
get_latest_responseC
Get the latest response from a service
Inputs: service (required).
initialize_browserA
Initialize the browser (use headless: false to see the browser)
Inputs: headless.
send_to_serviceA
Send input to Cloud Desktop, ChatGPT, or Gemini and get response
Inputs: content (required), service (required).
web_automation_queryA
Process natural language queries to interact with ChatGPT, Gemini, or Cloud Desktop. Examples: "Ask ChatGPT about quantum computing", "Send to Gemini: explain machine learning", "Clear ChatGPT conversation"
Inputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
web_automation_query overlaps heavily with send_to_service and also covers clearing conversations, making it unclear when to use which tool. Other tools are distinct, but the primary query tool's broad scope creates ambiguity.
Most tools follow a consistent verb_noun pattern (send_to_service, get_latest_response, clear_conversation, initialize_browser, cleanup_browser), but web_automation_query breaks the pattern as a noun_phrase, causing a minor inconsistency.
With 6 tools, the set is well-scoped for browser automation covering initialization, querying, response retrieval, conversation clearing, and cleanup. Each tool has a clear place in the workflow, and the count is appropriate.
The tool set covers the core lifecycle: initialize, send query, get response, clear conversation, and cleanup. Minor gaps exist (e.g., listing available services or fetching full conversation history), but they are not critical for the primary purpose.
Maintenance
Related MCP Connectors
Hosted Web Crawler MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Hosted X Ads MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that allows Claude Code to interact with the OpenAI Codex CLI.40 npm20MIT
- AlicenseCqualityDmaintenanceAn MCP server that gives Claude Code real browser control for web automation, testing, and screenshots.3246 npm158MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that allows Claude Desktop to remotely control Claude Code instances for executing commands and managing files.56 npmGPL 3.0
- AlicenseNot gradedqualityDmaintenanceMCP server that enables Claude Code to interact with Google's Gemini API for code analysis, chat, and summarization tasks.285 npmMIT