OpenDia

Connect your browser to AI models — no browser switching needed. Works seamlessly with Chrome, Firefox, and any Chromium browser. Private, local-first & MCP focused.

🚀 What is OpenDia?

OpenDia lets AI models control your browser automatically. The key advantage? It leverages everything you already have—your logged-in accounts, saved passwords, cookies, wallets, and browsing history. No need to start from scratch or switch contexts.

🔑 Use Your Existing Digital Life:

• ✅ Logged-in accounts: Post to Twitter/X, LinkedIn, Facebook with your existing sessions
• ✅ Browser data: Access your bookmarks, history, and saved passwords
• ✅ Extensions & wallets: Use MetaMask, password managers, or any installed extensions
• ✅ Cookies & sessions: Stay authenticated across all your favorite sites
• ✅ Local testing: Perfect for development with Cursor - test with real user sessions

✨ Key Benefits:

• 🔄 Universal AI Support: Works with Claude, ChatGPT, Cursor, Grok Build and even local models
• 🎯 Anti-Detection: Specialized bypasses for Twitter/X, LinkedIn, Facebook
• 📱 Smart Automation: AI understands your pages and finds the right elements
• 🛡️ Privacy-First: Everything runs locally, your data stays with you
• ⚡ Zero Setup: Get started with one command

🌐 Browser Support

Works with Chrome, Firefox, and any Chromium-based browser:

• ✅ Google Chrome
• ✅ Arc
• ✅ Mozilla Firefox
• ✅ Microsoft Edge
• ✅ Brave
• ✅ Opera
• ✅ Any Chromium based browser

Also perfect for Cursor users who want to automate their local testing and development workflows!

🔌 Compatible AI Clients

OpenDia exposes a standard MCP server, so it works with any client that speaks the protocol.

Tested:

• Claude Desktop — paste the config below, restart.
• Claude Code — same MCP config, runs from any terminal.
• Cursor — add via Settings → MCP, or paste the same JSON.
• Grok Build — install the OpenDia plugin or add the MCP block to ~/.grok/config.toml (see Grok Build below).
• ChatGPT — works with Auto-Tunnel mode (npx opendia --tunnel), then add the ngrok URL as a connector.

Should work (any MCP-compatible client): Windsurf, Zed, Continue, Cline, Goose, Open WebUI.

Wired it up with something else? Open a PR — the list grows as MCP grows.

🎬 What You Can Do

Real workflows you can try today:

📰 Content & Social Media

• "Summarize all the articles I read today and post a Twitter thread about the key insights"
• "Find interesting articles related to AI from my bookmarks and create a reading list"
• "Read this article and post a thoughtful comment on the LinkedIn version"
• "Check my recent Twitter bookmarks and summarize the main themes"

📧 Productivity & Research

• "Browse my latest emails and tell me what needs urgent attention"
• "Find all the GitHub repos I visited this week and create a summary report"
• "Extract the main points from this research paper and save them to my notes"
• "Search my browsing history for that article about AI safety I read last month"

🤖 Development & Testing (Perfect for Cursor!)

• "Test my web app's signup flow and take screenshots at each step"
• "Fill out this form with test data and check if validation works"
• "Navigate through my app and check if all the buttons work properly"
• "Use my connected wallet to test this DeFi interface"

🔄 Advanced Automation

• "Open tabs for all my daily news sources and summarize the top stories"
• "Draft replies to my unread messages based on the context"
• "Monitor this webpage and notify me when the content changes"
• "Automatically bookmark interesting articles I'm reading"

🎨 Visual Customization & Fun

• "Apply a cyberpunk theme to this documentation site to make it more engaging"
• "Make this page dark mode with green text for late-night reading"
• "Add rainbow party effects to celebrate finishing this project"
• "Transform this boring form with a retro 80s theme while I fill it out"
• "Use high contrast styling so I can read this better"

⚡ Quick Start

1. Install the Browser Extension

For Chrome/Chromium browsers:

1. Download the latest opendia-chrome-*.zip from releases
2. Extract the zip file to a folder
3. Go to chrome://extensions/ (or your browser's extension page)
4. Enable "Developer mode"
5. Click "Load unpacked" and select the extracted folder

For Firefox:

1. Download the latest opendia-firefox-*.zip from releases
2. Extract the zip file to a folder
3. Go to about:debugging#/runtime/this-firefox
4. Click "Load Temporary Add-on..."
5. Select the manifest.json file from the extracted folder

Note: Firefox extensions are loaded as temporary add-ons and will be removed when Firefox restarts. This is a Firefox limitation for unsigned extensions.

2. Connect to Your AI

Option 1: Double-click Installation (Recommended)

1. Download the opendia.dxt file from releases
2. Double-click the .dxt file to install automatically
3. The MCP will be added to your Claude Desktop configuration

The DXT settings in Claude Desktop (WebSocket Port, HTTP Port, Auto-Tunnel, Tunnel Auth Token) are passed to the server as the OPENDIA_* environment variables described under Port Configuration. If you move the HTTP port outside the ports the extension checks (5556-5558, 3001, 6001-6003), enter it under Custom HTTP Port in the extension popup. Safety Mode is a toggle in the extension popup, not a DXT setting.

Option 2: Manual Configuration Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "opendia": {
      "command": "npx",
      "args": ["opendia"]
    }
  }
}

For Cursor or other AI tools, use the same configuration or follow their specific setup instructions.

Grok Build

OpenDia ships a first-class Grok Build plugin under plugins/opendia/ (marketplace index: .grok-plugin/marketplace.json).

Option A — Plugin (recommended)

grok plugin marketplace add aeonfun/opendia
grok plugin install opendia --trust

Enable the plugin in /plugins (trust is required for MCP). Details, skills, and troubleshooting: plugins/opendia/README.md.

Option B — Manual config.toml

Add to ~/.grok/config.toml (or a project .grok/config.toml):

[mcp_servers.opendia]
command = "npx"
args = ["-y", "opendia"]
enabled = true
startup_timeout_sec = 60

Then install the browser extension and confirm it is connected to ws://localhost:5555.

grok mcp doctor opendia

Usage Modes

Local Mode (Default)

npx opendia

• Chrome extension: ws://localhost:5555 (auto-discovery enabled)
• Claude Desktop: stdio (existing config)
• Local SSE: http://localhost:5556/sse

Port Configuration

# Use custom ports
npx opendia --port=6000              # Uses 6000 (WebSocket) + 6001 (HTTP)
npx opendia --ws-port=5555 --http-port=5556  # Specify individually

# Handle port conflicts  
# Note: Existing OpenDia processes are automatically terminated on startup

The same settings can come from environment variables, which is how the Claude Desktop DXT applies its settings. A command-line flag always wins over the matching variable, and an empty variable counts as unset.

The browser extension finds the server by checking HTTP ports 5556-5558, 3001 and 6001-6003. For any other HTTP port, enter it under Custom HTTP Port in