BambooHR Connector for AI agents.

Q: How do I find a teammate's phone number through the agent?

Use the searchemployee tool and provide the teammate's name. Your agent will search the company directory and return their contact details, including phone and email.

Q: Can the agent tell me who is on vacation today?

Yes. The listwhosout tool provides a real-time list of all employees who are currently out of the office for time off, allowing you to check team availability instantly.

12 live capabilities

Manage employee records and time off requests through a conversational interface.

Live agent request BambooHR / Connector

Waiting for input…

AI Agent

Why people use BambooHR

BambooHR for Automating HR Records and Staff Data

This Connector changes that. You just ask your agent for the info. It pulls the data from BambooHR and puts it right in your chat. You get your answers without ever leaving your workspace.

What Vinkius changes

You get a conversational interface for your entire HR database.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

Real-world use case 01

The 'Who's out today?' check

A manager asks who is away today.
Real-world use case 02

Updating new hire records

An HR admin needs to update a new hire's phone number.
Real-world use case 03

Checking leave policies

A worker asks what types of leave they can take.

Complete set · 12capabilities

The complete BambooHR capability set.

These are the exact actions your AI can choose when you ask it to work with BambooHR.

Capability set01 / 03

01—04

4 capabilities in this set.

Part of 12 available through BambooHR.

01 Capability
Get employee details
Get the basic profile information for a specific staff member. This is useful for finding contact info or roles.
02 Capability
List employees directory
See a list of all active employees in the company directory. This gives you a quick overview of your current staff.
03 Capability
List time off policies
View all the different time off policies your company has set. Use this to check rules for vacation or sick leave.
04 Capability
List time off requests
View all submitted time off requests in the system. This helps you audit upcoming leave for your team.

Capability set02 / 03

05—08

4 capabilities in this set.

Part of 12 available through BambooHR.

05 Capability
List whos out
See who is currently away from the office today. This helps you plan meetings without checking a calendar.
06 Capability
Add time off request
Submit a new time off request for an employee. Use this to quickly log leave for your team members.
07 Capability
Get account check
Verify that your BambooHR connection is active and working. This ensures your agent has the correct permissions.
08 Capability
Get company report
Pull a specific company report using its unique ID. This lets you grab data without navigating the dashboard.

Capability set03 / 03

09—12

4 capabilities in this set.

Part of 12 available through BambooHR.

09 Capability
List time off types
See the different types of time off available for employees. This shows what categories like personal days are allowed.
10 Capability
Search employee
Find a specific person in the directory by typing their name. This is the fastest way to get a person's profile.
11 Capability
Update employee
Change basic information for an employee record. Use this to keep your HR records accurate and up to date.
12 Capability
Whos out
Check which employees are out of the office for a specific date range. This helps with long-term project planning.

Set up in minutes

One URL. Then ask BambooHR to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use BambooHR from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_QoRTiXBDTHuApumKZEwtpImI1nASB43Q2nnPx91Z/mcp

Step 01

Open Connectors

In Claude Web or Claude Desktop, open Settings and choose Connectors.
Step 02

Add the URL

Choose Add custom connector, name it BambooHR, and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable BambooHR for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_QoRTiXBDTHuApumKZEwtpImI1nASB43Q2nnPx91Z/mcp

Step 01

Open MCP settings

On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
Step 02

Add the URL

Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the BambooHR URL.
Step 03

Save and start

Save the connection and enable BambooHR in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "bamboohr": {
      "url": "https://edge.vinkius.com/vk_preview_QoRTiXBDTHuApumKZEwtpImI1nASB43Q2nnPx91Z/mcp"
    }
  }
}

Step 01

Open MCP Settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
Step 02

Add the server config

Paste the JSON configuration above into the mcp.json file that opens
Step 03

Save the file

Cursor will automatically detect the new Connector
Step 04

Start using BambooHR

Open Agent mode in chat and ask: "Using BambooHR, help me...". 12 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "bamboohr": {
      "url": "https://edge.vinkius.com/vk_preview_QoRTiXBDTHuApumKZEwtpImI1nASB43Q2nnPx91Z/mcp"
    }
  }
}

Step 01

Create MCP config

Create a .vscode/mcp.json file in your project root
Step 02

Add the server config

Paste the JSON configuration above
Step 03

Enable Agent mode

Open GitHub Copilot Chat and switch to Agent mode using the dropdown
Step 04

Start using BambooHR

Ask Copilot: "Using BambooHR, help me...". 12 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "bamboohr": {
      "url": "https://edge.vinkius.com/vk_preview_QoRTiXBDTHuApumKZEwtpImI1nASB43Q2nnPx91Z/mcp"
    }
  }
}

Step 01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Step 02

Add the server

Paste the JSON configuration above into mcp_config.json
Step 03

Save and reload

Windsurf will detect the new server automatically
Step 04

Start using BambooHR

Open Cascade and ask: "Using BambooHR, help me...". 12 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "bamboohr": {
      "url": "https://edge.vinkius.com/vk_preview_QoRTiXBDTHuApumKZEwtpImI1nASB43Q2nnPx91Z/mcp"
    }
  }
}

Step 01

Open Cline MCP Settings

Click the Connectors icon in the Cline sidebar panel
Step 02

Add remote server

Click "Add Connector" and paste the configuration above
Step 03

Enable the server

Toggle the server switch to ON
Step 04

Start using BambooHR

Ask Cline: "Using BambooHR, help me...". 12 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add bamboohr --transport http "https://edge.vinkius.com/vk_preview_QoRTiXBDTHuApumKZEwtpImI1nASB43Q2nnPx91Z/mcp"

Step 01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
Step 02

Add the Connector

Run the command above in your terminal
Step 03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
Step 04

Start using BambooHR

Ask Claude: "Using BambooHR, show me...". 12 tools are ready

Where the request belongs

Work BambooHR can move forward.

Built around the request

This is for HR admins who are tired of repetitive manual data entry and team managers who need to know availability without the back-and-forth emails.

HR Administrator

Updates employee records and pulls company reports without opening a browser tab.

Team Manager

Checks who is out of the office today to plan project sprints and meetings.

Operations Lead

Verifies employee contact details and organizational structures for onboarding.

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 9 capabilities

BambooHR

Human Resources management platform. organize employee data, track time off, and audit HR workflows via AI.

View Connector

02 12 capabilities

Hurma

Manage your HR processes with employee records, leave tracking, and performance reviews designed for growing teams.

View Connector

03 8 capabilities

Factorial

Modernize HR operations with time-off management, payroll processing, and performance reviews that employees actually enjoy using.

View Connector

04 8 capabilities

SmartHR

Empower your AI to manage employee records, organizational structures, and payrolls directly from your SmartHR workspace.

View Connector

05 11 capabilities

WebHR

Manage employees, attendance, and recruitment on WebHR with AI agents.

View Connector

06 10 capabilities

Beisen (iTalentX)

Comprehensive HR cloud platform. manage employees, attendance, and recruitment via AI.

View Connector

Bring your own AI

Change the model, client or framework. Keep BambooHR connected.

Claude
ChatGPT
Gemini
Cursor
VS Code
Windsurf
ZCode
Cline
Zed
Continue
Kiro
Roo Code
Zencoder
Goose
Void
Augment Code
Amp
Qodo
Tabnine
Pieces
Sourcegraph Cody
JetBrains
Warp
Amazon Q
Antigravity
BoltAI
Raycast
Jan
LM Studio
AnythingLLM
Open WebUI
Msty
Cherry Studio
LibreChat
TypingMind
Chorus
5ire
n8n
LangChain
LlamaIndex
CrewAI
Vercel AI SDK

Before you connect

Questions about BambooHR.

The practical details behind the request, access and result.

Can I use the BambooHR MCP to see who is on vacation?

Yes. You can ask your agent to check who is out of the office today or for any specific date range. It pulls this data directly from your HR records.

How does the BambooHR MCP help with employee records?

It allows you to search the directory, get specific profile details, and update basic information like contact numbers without leaving your chat.

Can I submit time off requests using the BambooHR MCP?

Yes. Your agent can submit new time off requests for employees based on your instructions, making it much faster to handle leave requests.

Is the BambooHR MCP good for small businesses?

It is ideal for small and medium businesses that use BambooHR to manage their people data and want a faster way to interact with that information.

How do I connect my BambooHR account to my AI client?

Once you subscribe via Vinkius, you just need to provide your BambooHR Subdomain and API Key in your preferred AI client settings.

Can the BambooHR MCP pull specific company reports?

Yes. If you have the report ID, your agent can pull that specific company report for you instantly.

How do I find a teammate's phone number through the agent?

Use the search_employee capability and provide the teammate's name. Your agent will search the company directory and return their contact details, including phone and email.

Can the agent tell me who is on vacation today?

Yes. The list_whos_out capability provides a real-time list of all employees who are currently out of the office for time off, allowing you to check team availability instantly.

Is it possible to submit a time off request via chat?

Absolutely. Use the add_time_off_request capability by providing the employee ID, start and end dates, and the specific Time Off Type ID (e.g., Vacation or Sick Leave).

One connection away

Give your agent a direct line to BambooHR.

Connect BambooHR once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available

BambooHR for Automating HR Records and Staff Data

You get a conversational interface for your entire HR database.

The 'Who's out today?' check

Updating new hire records

Checking leave policies

Get employee details

List employees directory

List time off policies

List time off requests

List whos out

Add time off request

Get account check

Get company report

List time off types

Search employee

Update employee

Whos out

Open Connectors

Add the URL

Turn it on in chat

Open MCP settings

Add the URL

Save and start

Open MCP Settings

Add the server config

Save the file

Start using BambooHR

Create MCP config

Add the server config

Enable Agent mode

Start using BambooHR

Open MCP Settings

Add the server

Save and reload

Start using BambooHR

Open Cline MCP Settings

Add remote server

Enable the server

Start using BambooHR

Install Claude Code

Add the Connector

Verify the connection

Start using BambooHR

HR Administrator

Team Manager

Operations Lead

BambooHR

Hurma

Factorial

SmartHR

WebHR

Beisen (iTalentX)

Give your agent a direct line to BambooHR.