toolbox-adk

library1.0.1pypypi✓ verified 85d ago

Integrates the MCP Toolbox with Google ADK (Agent Development Kit) for building AI agents. Version 1.0.0, Python >=3.10. Early release, rapid changes expected.

llm-agents gcp ai-ml web-framework

pip install toolbox-adk

github ↗package ↗changelog ↗

INSTALL

IMPORT

SIG · TOOLBOX-ADK

toolbox-adk

llm-agentspythonv1.0.1

Install

13.3s avg

Import

7968ms

Disk

122MB

Pass rate

8/ 10

Env Coverage8 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.0.1 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

✓ —

✓ 16s

py 3.11

✓ —

✓ 14.3s

py 3.12

✓ —

✓ 11.2s

py 3.13

✓ —

✓ 11.7s

py 3.9

✕ build_error

122MB installed

● package 122MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ToolboxTool

✓ from toolbox_adk import ToolboxTool

Common mistake: attempting 'import toolbox' instead of importing specific class.

Minimal setup to use a ToolboxTool inside an ADK agent.

from toolbox_adk import ToolboxTool from google.adk.agents import Agent from google.adk.tools import ToolContext url = os.environ.get('TOOLBOX_URL', 'http://localhost:8080') api_key = os.environ.get('TOOLBOX_API_KEY', '') toolbox_tool = ToolboxTool(url=url, api_key=api_key) agent = Agent(model='gemini-pro', tools=[toolbox_tool]) # Example usage for event in agent.run("What tools are available?"): print(event.content)

Debug

Known issues

breakingRequires Python >=3.10. Using older Python leads to SyntaxError or dependency conflicts.

fix

Upgrade Python to 3.10+ or use a virtual environment with the correct version.

affects: <3.10

gotchaThe Toolbox URL must point to a running MCP Toolbox server. Missing or invalid URL causes connection errors on first tool call.

fix

Ensure TOOLBOX_URL is set and the server is running before initializing the agent.

affects: all

deprecatedThe import path 'from toolbox_adk import ToolboxToolTool' was used in pre-release versions. That symbol is removed in 1.0.0.

fix

Use 'from toolbox_adk import ToolboxTool' instead.

affects: <1.0.0

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'toolbox_adk'

The package is not installed or installed in a different environment.

fix

Run 'pip install toolbox-adk' in your current environment.

ImportError: cannot import name 'ToolboxTool' from 'toolbox_adk'

The installed version is pre-1.0.0 and uses a different class name or the package is corrupted.

fix

Upgrade: 'pip install --upgrade toolbox-adk' and then import ToolboxTool.

ValueError: Missing URL for ToolboxTool. Provide a 'url' parameter or set the TOOLBOX_URL environment variable.

No URL specified and TOOLBOX_URL env var not set.

fix

Either pass url='http://...' to ToolboxTool constructor, or set TOOLBOX_URL environment variable.

Upgrade

Version history

1.0.1latest on PyPI · released May 18, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

48 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/googleapis/mcp-toolbox-sdk-python ↗

packagehttps://pypi.org/project/toolbox-adk/ ↗

changeloghttps://github.com/googleapis/mcp-toolbox-sdk-python/blob/main/packages/toolbox-adk/CHANGELOG.md ↗