How to Use the BambooHR MCP in Windsurf

Q: How do I install the BambooHR MCP Server in Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file. Add the server details under the mcpServers key, then click Refresh in the MCP panel. Cascade auto-discovers the tools immediately.

Q: How do I verify my HR connection?

Run the getaccountcheck tool. Your agent will confirm the API token is valid and the endpoint is responding correctly.

Q: Does Windsurf support searching the BambooHR directory?

You just tell Cascade who you are looking for. It uses searchemployee to find the exact match and returns their role, department, and contact details.

Connect Windsurf to your HR data to let Cascade handle time off requests and employee lookups without leaving your editor.

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 Windsurf

Create your Vinkius account to connect BambooHR to Windsurf 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Instant BambooHR directory access in Windsurf

The `search_employee` tool lets Cascade find specific teammates by name right inside your editor. When you need to know who manages the frontend team or check someone's department, you just ask. Cascade reads your prompt, queries the database, and pulls the exact profile matching your search. Combine this with `get_employee_details` for deeper context. If you're writing an internal tool that needs HR data, Cascade fetches the live fields automatically. You don't have to switch to a browser to copy-paste job titles or contact info.

Automate PTO tracking via MCP

Your agent can check who's on vacation using the `list_whos_out` tool. This matters when you're planning a sprint or trying to assign code reviews. Cascade checks the daily absences and warns you if a key reviewer is away. You can also manage your own requests. Cascade uses `list_time_off_types` to see your available buckets, then triggers `add_time_off_request` to submit the dates. It handles the entire multi-step process autonomously based on a single prompt.

Pull live HR reports via this MCP Server

The `get_company_report` tool grabs custom HR views directly from the platform. You tell Cascade which report ID you need, and it fetches the raw data. This skips the usual export-to-CSV dance. Your IDE can then parse that data to build internal dashboards or scripts. Because Cascade chains actions, it pulls the report, reads the schema, and writes the integration code in one fluid motion.

Setup guide

Set up BambooHR MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the BambooHR MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my BambooHR payment history." If connected, Cascade will call the BambooHR tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "bamboohr-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Windsurf

Open your ~/.codeium/windsurf/mcp_config.json file. Add the server details under the mcpServers key, then click Refresh in the MCP panel. Cascade auto-discovers the tools immediately.

Yes, Cascade handles the whole sequence. It checks your balance with `list_time_off_policies` and submits the dates via `add_time_off_request` without asking for step-by-step permission.

Run the `get_account_check` tool. Your agent will confirm the API token is valid and the endpoint is responding correctly.

You just tell Cascade who you are looking for. It uses `search_employee` to find the exact match and returns their role, department, and contact details.

Vinkius runs this connection inside a V8 Isolate Sandbox. When your IDE pulls sensitive fields via `get_employee_details` or reads PTO balances, the data stays ephemeral. We handle the auth token, and the session dies when the query finishes.

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