How to Use the BambooHR MCP in Google ADK

Q: How does Google ADK connect to this BambooHR server?

After installing google-adk, you'll use the McpToolset class and point it to your Vinkius server URL. Then you pass that toolset to your LlmAgent. You can also use the toolnames filter to expose only specific tools to your agent.

Q: Can I use Google ADK to find a specific person in my BambooHR directory?

Absolutely. The searchemployee tool is designed for that. Your Gemini agent can take a name, find the right person, and return their details like title and email address.

Q: How would I approve a time off request in BambooHR with Google ADK?

This server lets you addtimeoffrequest, but BambooHR's own approval workflow still applies. Your agent submits the request, and managers get a notification to approve it inside BambooHR as usual.

Connect Google ADK to BambooHR and build enterprise agents that act on your HR data inside Google Cloud.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect BambooHR MCP to Google ADK

Create your Vinkius account to connect BambooHR 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 BambooHR with Google ADK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Sync HR data to BigQuery.

This server gives your Gemini agent direct read-access to your HR directory. Use `list_employees_directory` to pull your entire staff roster. You can then pipe that data directly into a BigQuery table for large-scale analysis. Gemini's long context window means your agent can process the full employee list in one go. Once the data is in BigQuery, you can join it with other business metrics or build Looker Studio dashboards on top of your live HR data.

Automate enterprise HR reporting.

Pulling reports is no longer a manual task. Your agent can use `get_company_report` to fetch specific reports by ID and `whos_out` to get daily absence lists. This is raw data, ready for your own systems. You can set up a Cloud Function that triggers your Google ADK agent to run these reports on a schedule. Have it drop the results in a Cloud Storage bucket or write them to a database. It's a solid way to build automated reporting pipelines.

Build HR workflows with your Google ADK MCP Server.

Go beyond reading data and start automating actions. This MCP Server lets your agent `add_time_off_request` for employees or change records with `update_employee`. You can build a full-service HR agent inside your GCP environment. For example, an event in your sales CRM could trigger an agent to update an employee's department in BambooHR. Because it's all inside Google Cloud, the integrations are straightforward and the agent has the context it needs.

Setup guide

Set up BambooHR 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 BambooHR 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="BambooHR_agent",
    model="gemini-2.0-flash",
    instruction="You have access to BambooHR 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 BambooHR. 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 BambooHR 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 BambooHR MCP in Google ADK

After installing `google-adk`, you'll use the `McpToolset` class and point it to your Vinkius server URL. Then you pass that toolset to your `LlmAgent`. You can also use the `tool_names` filter to expose only specific tools to your agent.

Absolutely. The `search_employee` tool is designed for that. Your Gemini agent can take a name, find the right person, and return their details like title and email address.

This server lets you `add_time_off_request`, but BambooHR's own approval workflow still applies. Your agent submits the request, and managers get a notification to approve it inside BambooHR as usual.

You don't have to build and maintain the connection, handle auth, or write parsers for the API responses. This MCP Server provides a standard interface that your agent understands out of the box.

Vinkius runs each server in a V8 Isolate sandbox, completely separated from other servers. Your agent interacts with our endpoint, not your BambooHR instance directly. We only process employee records, time off data, and company reports, and the sandbox is destroyed after each session.

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