BambooHR MCP Server: ask Claude about employees, time off and reports

• Looks up coworkers in your company directory: name, team, title and contact details

  Searches the employee directory your company publishes, so anyone can find who a coworker is, what team they are on and how to reach them, even outside their own reporting line.

  Try: “Who is Priya Shah and what team is she on?”

  Network · get_employees_directory

• Lists and filters employees by department, location, manager or any field

  Searches the employee roster and filters or sorts it by fields such as department, location, manager or a custom field. People whose details you cannot see are left out.

  Try: “List everyone in the Sales department based in Denver.”

  Network · list_employees

• Shows one employee's record, such as job title, manager, hire date or contact details

  Opens a single employee's record and returns the fields you ask for, like job title, manager, hire date or work phone. Fields you are not allowed to see are left out.

  Try: “What is Dwight's hire date and who is his manager?”

  Network · get_employee

• Shows an employee's history tables, like past job titles or pay changes

  Reads the history tables on an employee's record, such as job history or compensation history, when your access level allows it.

  Try: “Show me Maria's job history over the last three years.”

  Network · get_employee_table_data

• Shows who is out and which company holidays fall in a date range

  Lists the people who are out of office and the company holidays between two dates.

  Try: “Who's out this week, and are there any company holidays coming up?”

  Network · list_whos_out

• Shows how much vacation, sick or other time off someone has left, on any date

  Returns an employee's time off balances for each category as of a date you choose. You need Time Off view permission for that person; being their manager is not enough.

  Try: “What are my time off balances?”

  Network · get_time_off_balance

• Lists time off requests in a date range, filtered by status, person or type

  Finds time off requests between two dates and can narrow them to pending, approved or denied, a single employee, or one type of leave.

  Try: “Show me all pending time off requests for my team next month.”

  Network · list_time_off_requests

• Submits a time off request for you or someone you manage

  Files a new time off request with dates and a leave type. It then goes through your company's normal approval flow.

  Try: “Create a vacation request for me for the last week of next month.”

  Write · create_time_off_request

• Approves, denies or cancels a time off request

  Changes the status of a time off request to approved, denied or cancelled, if you have permission to do that in BambooHR.

  Try: “Approve Jim's time off request for December 22 to 26.”

  Write · update_time_off_request_status

• Lists your company's time off types, like Vacation, Sick or Bereavement

  Returns the names of the leave types your company has set up, so the assistant uses the right name (your company may call PTO something else).

  Try: “What time off types do we have?”

  Network · list_time_off_types

• Lists your company's time off policies

  Returns the time off policies your company has set up, such as how leave is earned for different groups.

  Try: “What time off policies does the company have?”

  Network · list_time_off_policies

• Shows which time off policies apply to one employee

  Returns the time off policies assigned to a specific employee.

  Try: “Which time off policies is Pam on?”

  Network · list_employee_time_off_policies_v1_1

• Lists the saved reports you are allowed to run

  Returns the custom reports saved in BambooHR that your access level can see. Two people may see different lists.

  Try: “List the saved reports I have access to.”

  Network · list_reports

• Runs a saved BambooHR report and returns its results

  Runs one of the reports already built in BambooHR and returns its rows so the assistant can summarize or compare them.

  Try: “Run the quarterly turnover report and summarize it.”

  Network · get_report_by_id

• Answers custom questions by querying your HR data, with filters and sorting

  Runs a custom query against one of BambooHR's reporting datasets, with filters and sorting, to answer questions no saved report covers. Values you cannot see come back empty.

  Try: “How many people did we hire in each department this year?”

  Network · get_data_from_dataset_v2

• Lists someone's goals, filtered by status such as in progress or completed

  Returns an employee's goals and can filter them by status.

  Try: “What goals do I have in progress, and which are past due?”

  Network · list_goals

• Shows one goal in full, with its comments and what it can be aligned to

  Opens a single goal with its details, comments and the goals it can be aligned with.

  Try: “Show me the details and comments on my Q4 onboarding goal.”

  Network · get_goal_aggregate

• Shows a person's goals dashboard, including goals with milestones

  Returns a summary view of an employee's goals, including goals broken into milestones.

  Try: “Give me an overview of Kevin's goals and milestones.”

  Network · get_goals_aggregate_v1_2

• Counts a person's goals by status

  Returns how many goals an employee has in each status, such as in progress or completed.

  Try: “How many of my goals are completed versus in progress?”

  Network · get_goals_filters_v1_2

• Creates a new goal for an employee, with or without milestones

  Adds a new goal to an employee's record, optionally split into milestones.

  Try: “Create a goal for me to finish the security training by March 31, with three milestones.”

  Write · create_goal

• Edits a goal's details and adds or removes milestones

  Changes a goal's title, description, due date or other details, and adds or removes milestones.

  Try: “Move the due date on my hiring plan goal to February 15.”

  Write · update_goal_v1_1

• Sets how far along a goal is, as a percentage

  Updates the percent complete on a goal that has no milestones.

  Try: “Set my documentation goal to 60 percent complete.”

  Write · update_goal_progress

• Marks a goal milestone as done or not done

  Marks one milestone on a goal as complete or incomplete.

  Try: “Mark the first milestone on my training goal as complete.”

  Write · update_goal_milestone_progress

• Closes a goal

  Marks a goal as closed so it no longer shows as active.

  Try: “Close my Q3 sales goal.”

  Write · close_goal

• Reopens a goal that was closed

  Puts a closed goal back into an active state.

  Try: “Reopen my Q3 sales goal.”

  Write · reopen_goal

• Deletes a goal for good

  Permanently removes a goal from an employee's record. This cannot be undone.

  Try: “Delete the duplicate onboarding goal on my profile.”

  Delete · delete_goal

• Shows the comments on a goal

  Returns the comments left on a goal, along with whether you can edit or delete each one.

  Try: “What comments has my manager left on my leadership goal?”

  Network · list_goal_comments

• Adds a comment to a goal

  Posts a new comment on a goal, such as a progress update.

  Try: “Add a comment to my training goal saying I finished module two.”

  Write · create_goal_comment

• Edits a comment on a goal

  Changes the text of an existing comment on a goal.

  Try: “Fix the typo in my last comment on the training goal.”

  Write · update_goal_comment

• Deletes a comment on a goal

  Removes a comment from a goal. This cannot be undone.

  Try: “Delete my last comment on the training goal.”

  Delete · delete_goal_comment

• Lists open jobs and how many people applied to each

  Returns your job openings with the number of applicants for each. Needs access to hiring settings.

  Try: “What job openings are open right now, and how many candidates are in each?”

  Network · get_job_summaries

• Lists job applications, filtered by job, status or date

  Finds job applications and filters them, for example by opening, status or when they applied. Needs access to hiring settings.

  Try: “Show me candidates who applied in the last two weeks.”

  Network · get_applications

• Shows one application in full, with the candidate's answers and status history

  Opens a single job application with the candidate's answers to application questions and how their status has changed.

  Try: “Show me the full application for the top candidate on the designer role.”

  Network · get_application_details

• Adds a comment to a job application

  Posts a comment on a candidate's application, such as interview notes.

  Try: “Add a note to Alex's application: strong portfolio, schedule a second interview.”

  Write · create_application_comment

• Lists the files attached to an employee's record, without opening them

  Returns the names and categories of files attached to an employee. It does not return what is inside the files.

  Try: “What documents are on file for Oscar?”

  Network · list_employee_files

• Lists company files and their folders, without opening them

  Returns the company files stored in BambooHR and their categories. It does not return what is inside the files.

  Try: “What company policy files do we have in BambooHR?”

  Network · list_company_files

• Updates fields on an employee's record, such as phone number or job title

  Changes one or more fields on an employee's record, if your access level lets you edit them. Changes that need approval follow BambooHR's normal workflow.

  Try: “Update John's work phone number to 801-555-0100.”

  Write · update_employee

• Lists people your company employs abroad through BambooHR's global employment service

  Returns the people your company employs through BambooHR's global employment offering. Returns nothing if your company does not use it.

  Try: “Who do we employ through global employment?”

  Network · list_bhr_global_workers

• Shows how one person employed abroad is set up

  Returns the employment setup for a single person employed through BambooHR's global employment offering.

  Try: “Show me the employment setup for our contractor in Portugal.”

  Network · get_bhr_global_worker

• Lists your employer-of-record hires abroad and their status

  Returns the employments you run through an employer of record and the status of each.

  Try: “List our international hires and where each one is in the process.”

  Network · list_remote_employments

• Shows one employer-of-record hire in detail

  Returns the full details of a single employer-of-record employment.

  Try: “Show me the details of our new hire in Brazil.”

  Network · get_remote_employment

• Shows which onboarding steps are still open for a new hire abroad

  Lists the onboarding steps that are still outstanding for a person you are hiring through an employer of record.

  Try: “What onboarding steps are left for our new hire in Germany?”

  Network · list_remote_employment_onboarding_steps

• Lists the countries where you can hire through global employment

  Returns the countries where BambooHR's global employment offering lets you hire.

  Try: “Which countries can we hire in?”

  Network · list_supported_countries

• Shows what information you need to hire someone in a given country

  Returns the details you must provide to hire someone in a specific country.

  Try: “What do we need to hire someone in Canada?”

  Network · get_remote_json_schema

• Summarizes what global employment is currently costing you

  Returns a summary of your current costs for people employed through global employment.

  Try: “How much are we spending on global employment right now?”

  Network · get_remote_global_employment_pricing_summary

• Shows the questions that decide if someone can be a contractor in a country

  Returns the questionnaire used to check whether a person can be hired as a contractor in a specific country.

  Try: “What do we need to answer to hire a contractor in Spain?”

  Network · get_remote_contractor_eligibility_questionnaire_schema

• Converts an amount between currencies for offers and cost comparisons

  Converts a salary or cost from one currency to another so you can compare offers across countries.

  Try: “Convert a 70,000 euro salary to US dollars.”

  Network · convert_remote_currency

• Used by the assistant behind the scenes

  Looks up which employee fields your account has, including custom ones

  Lists every employee field in your BambooHR account. The assistant uses it to find the right field before it searches or updates records.

  Try: “What custom fields do we track on employee records?”

  Network · list_fields

• Looks up dropdown fields and their allowed values

  Lists the dropdown and multi-select fields in your account and the options each one allows, so the assistant uses valid values.

  Try: “What options are in the Division dropdown?”

  Network · list_list_fields

• Looks up the history tables on employee records and their fields

  Lists the tables on employee records, such as job or compensation history, and the fields in each.

  Try: “What history tables do we keep on employees?”

  Network · list_tabular_fields

• Looks up which reporting datasets it can query

  Lists the reporting datasets available to query. Needs elevated permissions.

  Try: “Which reporting datasets can I query?”

  Network · list_datasets_v1_2

• Looks up the fields inside a reporting dataset

  Lists the fields available in a reporting dataset before the assistant builds a query.

  Try: “What fields are in the employee dataset?”

  Network · get_fields_from_dataset_v1_2

• Looks up valid filter values for dataset fields

  Returns the values a dataset field can take, so the assistant filters with the right ones.

  Try: “What locations can I filter the employee dataset by?”

  Network · get_field_options_v1_2

• Looks up which goals a new goal can be aligned to

  Lists the goals that another goal can be linked to, such as a team or company goal.

  Try: “Which company goals can I align my new goal to?”

  Network · get_alignable_goal_options

• Looks up the applicant statuses your company uses in hiring

  Returns the candidate statuses your company has set up, such as Reviewed or Interviewing.

  Try: “What applicant statuses do we use?”

  Network · get_statuses

• Works out dates, tenure and upcoming work anniversaries accurately

  Does date math on BambooHR's side, such as how long someone has worked here or when an anniversary falls, because AI models often get dates wrong.

  Try: “How long has Dwight been with the company?”

  calculate_date

Watch out for

• It can change records and approve time off

  Write tools update employee fields, submit, approve or deny time off, and change goals. Turn off write tools in Configure if you only want answers. documentation.bamboohr.com

• It sees the sensitive HR data you can see

  It reaches whatever your BambooHR access reaches, which for admins includes job and pay history. Keep HR chats to BambooHR alone and check your AI app's training data setting. documentation.bamboohr.com

• Short answers may hide missing records

  Records and fields you cannot read are left out without a warning. Treat a short or empty answer as what you can see, not what exists. documentation.bamboohr.com

• Deleting a goal or goal comment is permanent

  Two tools delete goals and goal comments for good. Read the request before you approve it. documentation.bamboohr.com

Security advisories