Prepare the server locally
Run this once before adding it to Claude Code.
git clone https://github.com/the-dev-kumar/colab-mcp
cd colab-mcpThen follow the repository README for any remaining dependency or build steps.
Register it in Claude Code
claude mcp add colab-mcp -- bun /absolute/path/to/colab-bridge.jsReplace any placeholder paths in the command with the real path on your machine.
Make your agent remember this setup
colab-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Connect to remote Google Colab instances
- Execute arbitrary shell commands remotely
- Run persistent Python code blocks
- Monitor real-time system resource usage (CPU, GPU, RAM)
Tools 4
connect_to_colabLink to your running Colab instance.run_colab_shellExecute shell commands on the connected Colab instance.run_colab_pythonRun persistent Python code on the Colab instance.get_colab_system_infoMonitor CPU, GPU, and RAM usage of the Colab instance.Try it
Original README from the-dev-kumar/colab-mcp
Colab MCP Client (TypeScript)
A high-performance Model Context Protocol (MCP) server for controlling Google Colab instances via a reverse proxy (ngrok, serveo, etc.).
Features
connect_to_colab: Link to your running Colab instance.run_colab_shell: Execute shell commands.run_colab_python: Run persistent Python code.get_colab_system_info: Monitor CPU/GPU/RAM.
Quick Start (No Install)
You can run this MCP server directly using Bun:
bun https://github.com/DevAdalat/colab-mcp/releases/download/v1.0.0/colab-bridge.js
Adding to MCP Agents (Claude Desktop, etc.)
For a stable setup, it is recommended to download the file locally:
Download the binary/script:
curl -LO https://github.com/DevAdalat/colab-mcp/releases/download/v1.0.0/colab-bridge.jsAdd to Claude Desktop: Update your
claude_desktop_config.json(usually at~/Library/Application Support/Claude/claude_desktop_config.jsonon macOS):
{
"mcpServers": {
"colab-bridge": {
"command": "bun",
"args": [
"/absolute/path/to/colab-bridge.js"
]
}
}
}
Manual Installation
If you want to run it locally:
Install Dependencies:
bun installRun Server:
bun run index.ts
Requirements
- Bun runtime installed.
- A running Google Colab instance with the bridge script active.