Bamboohr MCP

让克劳德完全访问你的BambooHR——员工、休假、招聘、福利、培训等等。

](https://www.npmjs.com/package/bamboohr-mcp)  ](https://nodejs.org) 

______________________________________________________________________

A. 模型上下文协议 将克劳德连接到BambooHR的服务器。安装一次，然后用简单的英语与您的人力资源数据交谈——没有仪表板，也没有手动导出。

"Who's out next week?"
"Onboard Sarah Chen starting Monday — Engineering, reports to Maria."
"Show training compliance for the Sales team."
"Approve all pending PTO requests for my team."
"What's our average time-to-fill for engineering roles?"

______________________________________________________________________

包含什么

🔧 74 MCP工具 BambooHR API涵盖11个模块-员工、休假、时间跟踪、ATS、福利、培训、目标、报告、网络挂钩、文件和元数据。

📦 零部署设置 船舶作为 npx-可运行的包。在Claude配置中添加两行，就完成了。

🎭 30种基于角色的技能 为人力资源管理员、经理、招聘人员、员工、工资单、L&D和自动化管理员预先构建的工作流程——由使用它们的人组织。

🔌 随时随地工作 Claude Desktop、Claude Code CLI或任何兼容MCP的客户端。

______________________________________________________________________

快速入门

步骤1-获取BambooHR API密钥

1. 登录BambooHR
2. 单击您的个人资料图标（右上角）> API密钥
3. 点击 添加新密钥，命名并复制它

您的子域是BambooHR URL中的前缀，例如。 acme 从 acme.bamboohr.com.

______________________________________________________________________

步骤2--添加到Claude桌面

编辑您的配置文件：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "bamboohr": {
      "command": "npx",
      "args": ["-y", "bamboohr-mcp"],
      "env": {
        "BAMBOOHR_API_KEY": "your-api-key-here",
        "BAMBOOHR_SUBDOMAIN": "your-company-subdomain"
      }
    }
  }
}

重新启动克劳德桌面。

______________________________________________________________________

步骤3--或添加到Claude代码（CLI）

claude mcp add bamboohr \
  -e BAMBOOHR_API_KEY=your-api-key-here \
  -e BAMBOOHR_SUBDOMAIN=your-company-subdomain \
  -- npx -y bamboohr-mcp

______________________________________________________________________

步骤4——验证

打开克劳德，问： “显示BambooHR员工目录”

______________________________________________________________________

可用工具

👤 Employees — 6 tools

🏖️ Time Off — 8 tools

⏱️ Time Tracking — 5 tools

🎯 Applicant Tracking (ATS) — 9 tools

🏥 Benefits — 7 tools

📊 Reports & Datasets — 5 tools

🎓 Training — 6 tools

🏆 Goals & Performance — 7 tools

🔔 Webhooks — 7 tools

📁 Files — 6 tools

⚙️ Account & Metadata — 7 tools

______________________________________________________________________

技能——基于角色的工作流

技能是预先构建的提示，可以端到端地处理常见的人力资源工作流程。将它们复制到 ~/.claude/skills/ 在Claude Code中使用它们。

# Install all skills at once
cp -r skills/* ~/.claude/skills/

______________________________________________________________________

🗂️ 人力资源管理员

*适用于负责日常人力资源运营的人员。*

______________________________________________________________________

📈 人力资源经理/HRBP

*用于战略性人力资源可见性、分析和报告。*

______________________________________________________________________

🎯 招聘/人才招聘

*用于管理职位空缺、候选人和招聘渠道。*

______________________________________________________________________

👔 经理/团队负责人

*用于团队级别的可见性和日常审批。*

______________________________________________________________________

🙋 员工自助服务

*适用于管理自己人力资源需求的员工。*

______________________________________________________________________

💼 工资和福利管理

*用于管理福利登记和薪酬数据。*

______________________________________________________________________

🎓 培训与L&D

*用于跟踪学习计划和合规性。*

______________________________________________________________________

⚡ 自动化管理员

*适用于通过webhooks将BambooHR与其他系统集成的团队。*

______________________________________________________________________

发展

git clone https://github.com/acalder-techpm/bamboohr-mcp
cd bamboohr-mcp
npm install
npm run build

本地测试：

export BAMBOOHR_API_KEY=your-key
export BAMBOOHR_SUBDOMAIN=your-subdomain
node dist/index.js

与MCP Inspector的交互式测试：

npx @modelcontextprotocol/inspector node dist/index.js

______________________________________________________________________

认证

BambooHR使用HTTP基本Auth，并将您的API密钥作为用户名。此服务器自动处理它——只需设置 BAMBOOHR_API_KEY.

提示： API密钥继承创建它们的用户的权限。使用管理员用户密钥进行完全访问，或使用受限用户密钥进行只读集成。

要创建密钥，请执行以下操作： BambooHR>配置文件图标>API密钥>添加新密钥

______________________________________________________________________

例子

以下是三个真实世界的示例，展示了Claude如何使用此MCP服务器。

示例1：检查团队可用性

你说： “下周谁将加入工程团队？”

发生了什么： 克劳德打电话来 bamboohr_get_whos_out 使用下周的日期范围，然后与进行交叉引用 bamboohr_list_employees 已过滤到Engineering。它返回的摘要如下：

下周工程部门将有3人离职： - 陈莎拉 -PTO周一至周三 - 詹姆斯公园 -周一病假 - Lisa Nguyen -PTO全周 15名团队成员中有12名可用。

示例2：新员工入职

你说： “从3月17日开始，Maria Torres将担任平台软件工程师，向奥斯汀办公室的Alex Kim汇报工作。”

发生了什么： 克劳德打电话来 bamboohr_create_employee 根据提供的详细信息，然后致电 bamboohr_assign_time_off_policies 设置标准PTO。它返回：

已为创建员工记录 玛利亚·托雷斯 （ID:4521） - 部门：平台 - 职位名称：软件工程师 - 地点：德克萨斯州奥斯汀 - 主管：Alex Kim - 开始日期：2026年3月17日 - 分配的PTO政策：标准PTO、病假、公司假期

示例3：培训合规性报告

你说： “告诉我谁在人力资源部的HIPAA培训上逾期了。”

发生了什么： 克劳德打电话来 bamboohr_list_employees 那么，请联系人力资源部成员 bamboohr_get_employee_trainings 每个人都要检查HIPAA完成状态。它返回：

HIPAA培训合规性-人力资源部 8名团队成员中有2名逾期： - 汤姆·里维拉 -2026年2月15日到期（逾期22天） - 艾米·沃尔什 -2026年3月1日到期（逾期9天） 现有6名成员。下次续约到期日：2026年6月（李）。

______________________________________________________________________

隐私政策

此MCP服务器充当Claude和您的BambooHR帐户之间的本地桥梁。以下是数据的处理方式：

• 没有数据收集。 此服务器不会收集、存储或向第三方传输任何数据。它不会给家里打电话、发送分析或登录外部服务。
• 仅限本地执行。 服务器作为本地stdio进程在您的计算机上运行。所有API调用都直接从您的机器转到BambooHR的API(api.bamboohr.com).
• 凭证保留在本地。 你的 BAMBOOHR_API_KEY 和 BAMBOOHR_SUBDOMAIN 从本地环境变量中读取，并且从不在BambooHR的API之外的任何地方进行持久化、日志记录或传输。
• BambooHR的隐私政策适用。 从BambooHR API返回的数据受 BambooHR的隐私政策。此服务器不缓存或保留任何API响应。
• 您控制访问权限。 BambooHR中API密钥的权限决定了此服务器可以访问哪些数据。使用受限权限密钥限制范围。

______________________________________________________________________

支持

• 问题：
• 电子邮件： adam.calder@bamboohr.com
• 讨论：

______________________________________________________________________

贡献

PR欢迎。如果添加新工具或技能，请遵循中的现有模式 src/tools/ 和 skills/ 并打开一个带有用例简要描述的拉取请求。

______________________________________________________________________

许可证

麻省理工学院 --用☕ 和克劳德。