picoclaw-mcp-server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Stealth web browser for agents: search, fetch, click, download and type in persistent MCP sessions.
Web scraping, browser automation, screenshots and AI data extraction for AI agents via MCP.
Hosted MCP catalog with 30 tenant-isolated browser, RAG, AI, mail and media tools.
Browser MCP for logged-in tasks. Uses your Chrome — credentials stay local. Zero-token replay.
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 gradedqualityDmaintenanceEnables Claude to perform stealth browser automation with anti-detection, including navigation, clicking, typing, screenshots, and network monitoring via an MCP server.MIT
- AlicenseBqualityDmaintenanceProvides undetectable browser automation for LLM agents via MCP, enabling real Chrome interaction with stealth features, DOM accessibility, and DevTools integration.984MIT