How to Use the Basecamp MCP in Google ADK

Q: How do I register the Basecamp MCP Server in my Google ADK codebase?

In your Google ADK project, use McpToolset with StreamableHttpServerParameters pointing to your Vinkius endpoint. Pass this toolset into the tools parameter of your Google ADK LlmAgent to expose the Basecamp tools.

Q: Can Gemini models use Google ADK to write to-dos back to Basecamp?

No, Google ADK uses read-only tools like listtodos and listtodolists to inspect Basecamp tasks. Your Gemini model can analyze these lists and suggest updates inside Google ADK, but it cannot modify them in Basecamp.

Q: Does Google ADK support filtering specific Basecamp tools?

Yes, you can use the toolnames filter in the Google ADK setup to restrict your agent to specific Basecamp tools like getproject. This prevents the Google ADK agent from calling unauthorized Basecamp tools during enterprise runs.

Q: How does Google ADK handle long-context reasoning with Basecamp data?

The Google ADK feeds raw outputs from Basecamp tools like listmessages directly into Gemini's context window. This allows the Google ADK model to analyze years of Basecamp project history in a single execution step.

Feed Basecamp project data directly into your Google ADK enterprise agents for deep reasoning over long contexts.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Basecamp MCP to Google ADK

Create your Vinkius account to connect Basecamp to Google ADK and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Basecamp with Google ADK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Analyze Basecamp project boards with Google ADK.

The `list_messages` tool pulls entire Basecamp message board histories into the Google ADK context window. Because Gemini models handle over a million tokens, your Google ADK agent can ingest every single Basecamp thread from a project and cross-reference them with BigQuery tables. You configure this tool within your Google ADK `McpToolset` to feed historical Basecamp updates directly to your enterprise model. The Google ADK uses this Basecamp data to build performance reports without hitting local storage limits.

Sync Basecamp campfire logs via this MCP Server.

The `list_campfire_lines` tool retrieves raw Basecamp chat logs so your Google ADK agent can analyze team communication patterns. By exposing this tool to your Google ADK `LlmAgent`, you let Gemini parse casual Basecamp chat lines for hidden project risks. You can restrict access to this tool using the Google ADK's `tool_names` filter to ensure only specific compliance agents can read the Basecamp chat history. This keeps your internal Basecamp communications secure while still allowing automated analysis in Google ADK.

Map Basecamp team structures to Google Cloud resources.

The `list_people` tool extracts your Basecamp user directory to help your Google ADK agent map tasks to actual employees. The Google ADK agent uses this tool alongside `list_projects` to determine which team members are allocated to which active Basecamp initiatives. This mapping helps enterprise teams sync their Basecamp directory with Google Cloud IAM roles via Google ADK. Your Google ADK agent runs these checks in a secure Google Cloud environment, matching external Basecamp project access to internal corporate directories.

Setup guide

Set up Basecamp MCP in Google ADK

Prerequisites

Python 3.10+ installed
google-adk package (pip install google-adk)
Active Vinkius subscription with a valid endpoint token

1

Install Google ADK

Run pip install google-adk to install the Agent Development Kit. MCP support is included via the McpToolset class.
2

Connect via SSE transport

Use McpToolset.from_server() with SseServerParams pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create an LlmAgent

Pass the returned mcp_tools list directly to LlmAgent(tools=mcp_tools). The ADK maps each MCP tool to a native Gemini function call — no manual schema definitions required.
4

Run with any Gemini model

The agent works with any Gemini model (gemini-2.0-flash, gemini-2.5-pro, etc.). Copy the full example on the right to get started with Basecamp tools in your ADK agent.

agent.py

from google.adk.agents import LlmAgent
from google.adk.tools.mcp_tool.mcp_toolset import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import SseServerParams

# Connect to the MCP via SSE
mcp_tools, exit_stack = await McpToolset.from_server(
    connection_params=SseServerParams(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    )
)

# Create your agent with auto-discovered tools
agent = LlmAgent(
    name="Basecamp_agent",
    model="gemini-2.0-flash",
    instruction="You have access to Basecamp tools via MCP.",
    tools=mcp_tools,
)

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Basecamp. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Basecamp now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Basecamp MCP in Google ADK

In your Google ADK project, use `McpToolset` with `StreamableHttpServerParameters` pointing to your Vinkius endpoint. Pass this toolset into the `tools` parameter of your Google ADK `LlmAgent` to expose the Basecamp tools.

No, Google ADK uses read-only tools like `list_todos` and `list_todolists` to inspect Basecamp tasks. Your Gemini model can analyze these lists and suggest updates inside Google ADK, but it cannot modify them in Basecamp.

Yes, you can use the `tool_names` filter in the Google ADK setup to restrict your agent to specific Basecamp tools like `get_project`. This prevents the Google ADK agent from calling unauthorized Basecamp tools during enterprise runs.

The Google ADK feeds raw outputs from Basecamp tools like `list_messages` directly into Gemini's context window. This allows the Google ADK model to analyze years of Basecamp project history in a single execution step.

All Basecamp message boards and campfire lines are processed within Vinkius's zero-trust V8 sandbox before reaching Google ADK. Your Basecamp data is encrypted in transit and never stored on persistent disks during Google ADK agent execution.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript