picoclaw-mcp-server
Click on "Install 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., "@picoclaw-mcp-servernavigate to google.com and search for MCP servers"
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.
picoclaw-mcp-server
A Model Context Protocol (MCP) server with browser automation, GitHub integration, and persistent opencode repository support.
Features
Browser Automation
Human-like behavior: Random delays, bezier-curve mouse movements, viewport/user-agent randomization
Stealth mode: Avoids bot detection using playwright-stealth
Full browser control: Navigate, click, type, scroll, hover, screenshot, get page content
GitHub Integration
List repository files
Read file contents
Search code
Search repositories
Get repository information
OpenCode Integration (Persistent)
Auto-clone/pull: Automatically clone or pull your opencode repository on startup
Heartbeat refresh: Periodic automatic refresh (configurable interval)
Manual refresh: MCP tools to force pull/refresh
Local file access: Read, list, and search your opencode repository
Utilities
Web search via DuckDuckGo
URL fetching
Related MCP server: mcp-chrome-server
Installation
# Clone the repository
git clone https://github.com/Evansxm/picoclaw-mcp-server.git
cd picoclaw-mcp-server
# Create virtual environment
python -m venv venv
source venv/bin/activate # Linux/Mac
# venv\Scripts\activate # Windows
# Install dependencies
pip install -r requirements.txt
# Install Playwright browsers
playwright install chromiumConfiguration
Environment Variables
Variable | Default | Description |
| - | GitHub Personal Access Token for higher rate limits |
|
| Run browser in headless mode |
|
| Enable stealth mode to avoid bot detection |
|
| Enable opencode repository integration |
| - | URL of your opencode repository |
|
| Local path to clone the repository |
|
| Seconds between automatic refreshes |
Configuration File
You can also configure via ~/.picoclaw/config.json:
{
"opencode": {
"enabled": true,
"repo_url": "https://github.com/yourusername/your-opencode-repo",
"local_path": "~/opencode-clone",
"refresh_interval": 1800,
"github_token": "your-github-token"
}
}Claude Desktop Configuration
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"picoclaw": {
"command": "/path/to/picoclaw-mcp-server/venv/bin/python",
"args": ["/path/to/picoclaw-mcp-server/server.py"],
"env": {
"GITHUB_TOKEN": "your-github-token-here",
"OPENCODE_ENABLED": "true",
"OPENCODE_REPO_URL": "https://github.com/yourusername/your-repo",
"HEADLESS": "false",
"STEALTH_MODE": "true"
}
}
}
}Cursor Configuration
Add to Cursor settings (Settings → Tools → MCP):
{
"mcpServers": {
"picoclaw": {
"command": "python",
"args": ["/absolute/path/to/picoclaw-mcp-server/server.py"],
"env": {
"GITHUB_TOKEN": "your-github-token-here",
"OPENCODE_ENABLED": "true"
}
}
}
}Available Tools
OpenCode Tools
Tool | Description |
`opencode | Force pull/refresh the opencode repository |
| Clone or ensure repository exists locally |
| List files in the opencode repository |
| Read a file from the opencode repository |
| Search for code in the opencode repository |
| Get status of the opencode repository |
Browser Tools
Tool | Description |
| Navigate to a URL |
| Click element by CSS selector |
| Click element by text content |
| Type text into input |
| Scroll the page |
| Take a screenshot |
| Get screenshot as base64 |
| Get page text content |
| Get page HTML source |
| Hover over element |
| Wait for seconds |
| Close browser |
GitHub Tools
Tool | Description |
| List files in a repository |
| Read file contents |
| Search code on GitHub |
| Search repositories |
| Get repository information |
Utility Tools
Tool | Description |
| Search the web via DuckDuckGo |
| Fetch URL content |
Systemd Service (Always-On)
For persistent always-on behavior on Linux:
# Copy the service file
sudo cp picoclaw-mcp.service /etc/systemd/system/
# Reload systemd
sudo systemctl daemon-reload
# Enable and start the service
sudo systemctl enable picoclaw-mcp
sudo systemctl start picoclaw-mcp
# Check status
sudo systemctl status picoclaw-mcpSystemd Service Customization
Edit the service file to customize:
[Service]
Environment="OPENCODE_REPO_URL=https://github.com/yourusername/your-repo"
Environment="OPENCODE_REFRESH_INTERVAL=1800"
Environment="HEADLESS=true"Development
# Run with MCP Inspector
uv run mcp dev server.py
# Run directly
python server.pyLicense
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables automated GitHub login through browser automation using Playwright. Provides MCP tools for programmatic authentication to GitHub accounts with credential management.1
- FlicenseCqualityDmaintenanceEnables browser automation, including navigation, form filling, login with CAPTCHA handling, and element manipulation, using a Chrome-based MCP server.364
- AlicenseNot gradedqualityBmaintenanceEnables Claude to perform stealth browser automation with anti-detection, including navigation, clicking, typing, screenshots, and network monitoring via an MCP server.MIT
- AlicenseBqualityCmaintenanceProvides undetectable browser automation for LLM agents via MCP, enabling real Chrome interaction with stealth features, DOM accessibility, and DevTools integration.983MIT
Related MCP Connectors
Stealth web browser for agents: search, fetch, click and type through persistent sessions over MCP.
Browser MCP for logged-in tasks. Uses your Chrome — credentials stay local. Zero-token replay.
Hosted real Google Chrome MCP with per-user persistent state. Navigate, click, type, screenshot.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Evansxm/picoclaw-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server