Get started with PyDoll MCP Server in 5 minutes and experience browser automation with Claude.

Before starting, make sure you have the following installed:

• Python 3.8+ (Recommended: 3.9 or higher)
• Chrome or Edge browser
• Claude Desktop (Latest version)
• Internet connection

pip install pydoll-mcp

After installation is complete, setup options will be automatically displayed:

🤖 Setting up PyDoll MCP Server...

🎉 PyDoll MCP Server installation complete!
============================================================

🚀 Quick Start Options:
1. 🔧 Auto-configure Claude Desktop
2. 📋 Manually create configuration file
3. 🧪 Test installation
4. ⏭️  Configure later

🎯 Choose an option (1-4): 1

Recommended: Select option 1 to proceed with automatic setup.

python -m pydoll_mcp.cli auto-setup

Auto setup performs the following:

• ✅ Verify installation status
• ✅ Find Claude Desktop configuration file location
• ✅ Backup existing configuration
• ✅ Add PyDoll MCP Server configuration
• ✅ Verify configuration works

python -m pydoll_mcp.cli test-installation --verbose

Expected output:

✅ Python version check: 3.9.7
✅ Required packages installed
✅ Browser detected: Chrome 115.0.0.0
✅ MCP server can start
✅ All tests passed!

python -m pydoll_mcp.cli test-browser --browser chrome

1. Completely close Claude Desktop
2. Restart Claude Desktop
3. Check if "🔌 MCP" indicator appears at the bottom

Send the following message in Claude Desktop to verify integration:

Start a browser and navigate to https://example.com

If successfully integrated, PyDoll will start the browser and navigate to the page.

Start a browser and go to Google

Search for "PyDoll MCP Server" on Google

Take a screenshot of the current page

Extract the titles of search results from this page

• Open a new browser window
• Close the current browser
• Open a new tab

• Navigate to [URL]
• Refresh the page
• Go back
• Go forward

• Find and click the login button
• Type "keyword" in the search box
• Click the submit button

• Tell me the page title
• Tell me the current URL
• Extract all links from the page

Go to the Naver login page and enter '[email protected]' in the ID field and 'password123' in the password field

Search for "wireless earphones" on Coupang and extract the product names and prices from the first page

Get 5 article titles and links related to "artificial intelligence" from Naver News

Log in to Instagram and check the number of likes on the latest post

# Check browser path
python -c "from pydoll.browser import Chrome; print('Browser check successful')"

# Check permissions (Linux/macOS)
ls -la /usr/bin/google-chrome

# Check configuration file location
python -m pydoll_mcp.cli status --logs

# Regenerate configuration
python -m pydoll_mcp.cli auto-setup --force

# Set encoding
set PYTHONIOENCODING=utf-8
python -m pydoll_mcp.server

# Enable debug logging
export PYDOLL_DEBUG=1
export PYDOLL_LOG_LEVEL=DEBUG

# Run server
python -m pydoll_mcp.server --debug

• [🛠️ Tools Reference](Tools-Reference) - Detailed description of all tools
• [🛡️ Security Bypass](Security-Bypass) - CAPTCHA and security bypass
• [📊 Data Extraction](Data-Extraction) - Web data extraction methods
• [🌐 Network Control](Network-Control) - Network monitoring

• [⚙️ Advanced Configuration](Advanced-Configuration) - Performance optimization
• [🎨 Customization](Customization) - Custom settings

• [🔍 Troubleshooting](Troubleshooting) - Detailed troubleshooting guide
• [❓ FAQ](FAQ) - Frequently asked questions
• [📞 Support](Support) - Community support

1. Use specific commands: Instead of "click the button", use "click the login button"
2. Step-by-step approach: Break complex tasks into multiple steps
3. Check for errors: Verify results after each step
4. Utilize screenshots: Save screenshots at important steps

• Use headless mode (no screen display)
• Disable image loading
• Enable ad blocking
• Set appropriate wait times

• Be careful when entering personal information
• Recommend using public accounts
• Comply with website terms of service
• Prevent excessive requests

Congratulations! 🎉
PyDoll MCP Server has been successfully configured.
Now experience powerful browser automation with Claude!

Learn Basic Usage | Tools Reference | Troubleshooting