Colab-mcp

Colab-mcp

An MCP server for bridging your local agent to a Colab session in the browser.

Supported Clients

This MCP server requires client support for notifications/tools/list_changed and for the client to be running locally on your device.

Popular clients that fit these criteria include:

• Gemini CLI
• Claude Code
• Windsurf

Setup

• Install uv (pip install uv)
• Configure for usage (eg for mcp.json style services):

...
  "mcpServers": {
    "colab-mcp": {
      "command": "uvx",
      "args": ["git+https://github.com/googlecolab/colab-mcp"],
      "timeout": 30000
    }
  }
...

(If you have a non-standard default package index (Googlers), you may also need to add --index https://pypi.org/simple)

Issues & Discussions

We are using GitHub discussions as theplace for issue discussion and feature requests. As discussions mature into action items, wewill add those items as issues. This helps us ensure that issues in the issue tracker arewell-understood, deduplicated, and actionable. For these reasons, please do NOT openissues directly.

Contributing

We unfortunately don't have the bandwidth to support review of external contributions, and wedon't want user PRs to languish, so we aren't accepting any external contributions right now.

If you have a great idea or pain point, we would love to hear about it on ourdiscussions page - the preferred placefor issue discussion and feature requests.

Internal - For Colab Developers

Prerequisites

• uv is required (pip install uv)
• Configure git hooks to run repo presubmits

git config core.hooksPath .githooks

Gemini CLI setup

...
  "mcpServers": {
    "colab-mcp": {
      "command": "uv",
      "args": ["run", "colab-mcp"],
      "cwd": "/path/to/github/colab-mcp",
      "timeout": 30000
    }
  }
...