{"_id":"@aot-tech/bamboohr-mcp-server","_rev":"6-47e0002cbe390b546bdfd34d55a2e6d8","name":"@aot-tech/bamboohr-mcp-server","dist-tags":{"latest":"1.0.4"},"versions":{"1.0.0":{"name":"@aot-tech/bamboohr-mcp-server","version":"1.0.0","keywords":["mcp","bamboohr","typescript","hr"],"author":{"name":"K Syama"},"license":"MIT","_id":"@aot-tech/bamboohr-mcp-server@1.0.0","maintainers":[{"name":"gopu-aot","email":"gopu.k@aot-technologies.com"},{"name":"syama.sundara","email":"syama.sundara@aot-technologies.com"},{"name":"hasgar-aot","email":"hasgar.d@aot-technologies.com"}],"bin":{"bamboohr-mcp-server":"build/index.js"},"dist":{"shasum":"05a4a5090113dd08c28062637ec835b20d1ef7b2","tarball":"https://registry.npmjs.org/@aot-tech/bamboohr-mcp-server/-/bamboohr-mcp-server-1.0.0.tgz","fileCount":50,"integrity":"sha512-wS4BKB+9QaWtrZXDKqLQ+/xkqFdrzCwh/HJYi1rRR1/PTId9gJn243TKLWZS31jyrYWxsL8hNxiu4c6ZoFZ9qQ==","signatures":[{"sig":"MEUCIQDuHizcPEHreBih0ZmBDHWfzdS5E71QouyQH0jBJBcwKgIgcV9HNe9ENJsziihBQW4BpUdhj6kNefsAzEvlA178ARY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":109010},"main":"build/index.js","types":"./build/index.d.ts","engines":{"npm":">=8.0.0","node":"18.x"},"gitHead":"11c8e56a8ad2b2268eb821265de72e9563515039","scripts":{"dev":"cross-env PORT=3002 IS_LOCAL=true NODE_ENV=development TZ='UTC' nodemon","test":"node --test test/*.test.js","build":"tsc","start":"node build/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"syama.sundara","email":"syama.sundara@aot-technologies.com"},"_npmVersion":"11.4.2","description":"BambooHR MCP Server","directories":{},"_nodeVersion":"20.18.3","dependencies":{"zod":"^3.24.2","cors":"^2.8.5","axios":"^1.8.4","dotenv":"^16.5.0","express":"^4.18.2","cross-env":"^7.0.3","@types/cors":"^2.8.19","@modelcontextprotocol/sdk":"^1.11.0"},"_hasShrinkwrap":false,"devDependencies":{"shx":"^0.4.0","tsx":"^4.7.0","nodemon":"^3.1.0","typescript":"^5.3.3","@types/node":"^18.19.0","@types/express":"^4.17.21"},"_npmOperationalInternal":{"tmp":"tmp/bamboohr-mcp-server_1.0.0_1757664487152_0.1607909376465475","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@aot-tech/bamboohr-mcp-server","version":"1.0.1","keywords":["mcp","bamboohr","typescript","hr"],"author":{"name":"K Syama"},"license":"MIT","_id":"@aot-tech/bamboohr-mcp-server@1.0.1","maintainers":[{"name":"gopu-aot","email":"gopu.k@aot-technologies.com"},{"name":"syama.sundara","email":"syama.sundara@aot-technologies.com"},{"name":"hasgar-aot","email":"hasgar.d@aot-technologies.com"}],"bin":{"bamboohr-mcp-server":"build/index.js"},"dist":{"shasum":"902827c13aaf623b303c50a9cbbfa03af791a925","tarball":"https://registry.npmjs.org/@aot-tech/bamboohr-mcp-server/-/bamboohr-mcp-server-1.0.1.tgz","fileCount":50,"integrity":"sha512-8JDml+iLA9F0dx+Y1sVqRCl4r8mO3DWCbQMuq4HvIkvG9+ZCK18jeRbxkC5XSjtmIksg5BAl8fbTALCuMLUdJg==","signatures":[{"sig":"MEYCIQD5jLz+v9iPty+Nemw5csJTWKyy5Rligqx6PxjIhL/guwIhAM9IzVsllVo294uzzsz6VpnKNjGrHxxtagL2Tb05ZSoY","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":108541},"main":"build/index.js","types":"./build/index.d.ts","engines":{"npm":">=8.0.0","node":"18.x"},"gitHead":"0f16d7a38b443318c5daf2404adf9514cb559b83","scripts":{"dev":"cross-env PORT=3002 IS_LOCAL=true NODE_ENV=development TZ='UTC' nodemon","test":"node --test test/*.test.js","build":"tsc","start":"node build/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"syama.sundara","email":"syama.sundara@aot-technologies.com"},"_npmVersion":"11.4.2","description":"BambooHR MCP Server","directories":{},"_nodeVersion":"20.18.3","dependencies":{"zod":"^3.24.2","cors":"^2.8.5","axios":"^1.8.4","dotenv":"^16.5.0","express":"^4.18.2","cross-env":"^7.0.3","@types/cors":"^2.8.19","@modelcontextprotocol/sdk":"^1.11.0"},"_hasShrinkwrap":false,"devDependencies":{"shx":"^0.4.0","tsx":"^4.7.0","nodemon":"^3.1.0","typescript":"^5.3.3","@types/node":"^18.19.0","@types/express":"^4.17.21"},"_npmOperationalInternal":{"tmp":"tmp/bamboohr-mcp-server_1.0.1_1757665673823_0.07829320768603099","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@aot-tech/bamboohr-mcp-server","version":"1.0.2","keywords":["mcp","bamboohr","typescript","hr"],"author":{"name":"K Syama"},"license":"MIT","_id":"@aot-tech/bamboohr-mcp-server@1.0.2","maintainers":[{"name":"gopu-aot","email":"gopu.k@aot-technologies.com"},{"name":"syama.sundara","email":"syama.sundara@aot-technologies.com"},{"name":"hasgar-aot","email":"hasgar.d@aot-technologies.com"}],"bin":{"bamboohr-mcp-server":"build/index.js"},"dist":{"shasum":"d260624ab45917af647ff080e629804fb68d9cf6","tarball":"https://registry.npmjs.org/@aot-tech/bamboohr-mcp-server/-/bamboohr-mcp-server-1.0.2.tgz","fileCount":50,"integrity":"sha512-nrrTVbWlYbg9XiOqzZilSTw/uj8dnNwmtBWQDaBW55pJoByXTBe23hctxF1hSFhMcGG1liiPtBFGKBoKnk7EYQ==","signatures":[{"sig":"MEUCIQC03WBFwvX5n+nHpxY2KeLFbDMPLjVVnV9IqX5RqblprQIgMevuyijI6zEq3RvmIyhKClecUvBUKZ2CyfnjitYr394=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":107023},"main":"build/index.js","types":"./build/index.d.ts","engines":{"npm":">=8.0.0","node":"18.x"},"gitHead":"a5015794f1cddbf285a05f587cb0f1d1d4794649","scripts":{"dev":"cross-env PORT=3002 IS_LOCAL=true NODE_ENV=development TZ='UTC' nodemon","test":"node --test test/*.test.js","build":"tsc","start":"node build/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"syama.sundara","email":"syama.sundara@aot-technologies.com"},"_npmVersion":"11.4.2","description":"BambooHR MCP Server","directories":{},"_nodeVersion":"20.18.3","dependencies":{"zod":"^3.24.2","cors":"^2.8.5","axios":"^1.8.4","dotenv":"^16.5.0","express":"^4.18.2","cross-env":"^7.0.3","@types/cors":"^2.8.19","@modelcontextprotocol/sdk":"^1.11.0"},"_hasShrinkwrap":false,"devDependencies":{"shx":"^0.4.0","tsx":"^4.7.0","nodemon":"^3.1.0","typescript":"^5.3.3","@types/node":"^18.19.0","@types/express":"^4.17.21"},"_npmOperationalInternal":{"tmp":"tmp/bamboohr-mcp-server_1.0.2_1757667167500_0.9929368752122032","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@aot-tech/bamboohr-mcp-server","version":"1.0.3","keywords":["mcp","bamboohr","typescript","hr"],"author":{"name":"K Syama"},"license":"MIT","_id":"@aot-tech/bamboohr-mcp-server@1.0.3","maintainers":[{"name":"gopu-aot","email":"gopu.k@aot-technologies.com"},{"name":"syama.sundara","email":"syama.sundara@aot-technologies.com"},{"name":"hasgar-aot","email":"hasgar.d@aot-technologies.com"}],"bin":{"bamboohr-mcp-server":"build/index.js"},"dist":{"shasum":"c6d3fdccfb688da172248c6bd839abdb6f4e8146","tarball":"https://registry.npmjs.org/@aot-tech/bamboohr-mcp-server/-/bamboohr-mcp-server-1.0.3.tgz","fileCount":54,"integrity":"sha512-02vSY9aHpODY4Uu/MgrETXCe40XIYzSR5V3Xg4H0+pqpT4ePLbKR29FJTQ0d/7MOm6XPq+q6tcaMhQSfoHh0kg==","signatures":[{"sig":"MEQCIDISZ8/5DFu/gfRZu3V1ZMm7b7ZnuVWEDIkX9vF81MdDAiBHjbTwHecJqiF4L9iPwLLV/5A99JPXigiYgC1AgZ77IA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":119942},"main":"build/index.js","types":"./build/index.d.ts","engines":{"npm":">=8.0.0","node":"18.x"},"gitHead":"545eebae6f410409bd36918391ce6506f3501e61","scripts":{"dev":"cross-env PORT=3002 IS_LOCAL=true NODE_ENV=development TZ='UTC' nodemon","test":"node --test test/*.test.js","build":"tsc","start":"node build/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"syama.sundara","email":"syama.sundara@aot-technologies.com"},"_npmVersion":"11.4.2","description":"BambooHR MCP Server","directories":{},"_nodeVersion":"20.18.3","dependencies":{"zod":"^3.24.2","cors":"^2.8.5","axios":"^1.8.4","dotenv":"^16.5.0","express":"^4.18.2","cross-env":"^7.0.3","@types/cors":"^2.8.19","@modelcontextprotocol/sdk":"^1.11.0"},"_hasShrinkwrap":false,"devDependencies":{"shx":"^0.4.0","tsx":"^4.7.0","nodemon":"^3.1.0","typescript":"^5.3.3","@types/node":"^18.19.0","@types/express":"^4.17.21"},"_npmOperationalInternal":{"tmp":"tmp/bamboohr-mcp-server_1.0.3_1760595663656_0.6473450662481037","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@aot-tech/bamboohr-mcp-server","version":"1.0.4","keywords":["mcp","bamboohr","typescript","hr"],"author":{"name":"K Syama"},"license":"MIT","_id":"@aot-tech/bamboohr-mcp-server@1.0.4","maintainers":[{"name":"gopu-aot","email":"gopu.k@aot-technologies.com"},{"name":"syama.sundara","email":"syama.sundara@aot-technologies.com"},{"name":"hasgar-aot","email":"hasgar.d@aot-technologies.com"}],"bin":{"bamboohr-mcp-server":"build/index.js"},"dist":{"shasum":"c3d6a6fc212cb9c3466be722cba81e7990d24024","tarball":"https://registry.npmjs.org/@aot-tech/bamboohr-mcp-server/-/bamboohr-mcp-server-1.0.4.tgz","fileCount":54,"integrity":"sha512-UU/m555GZP5nsX+UwTeIF3nEb98/XvU+YXlyWWf1sK9Uzs5DxUHDNPQd6beRWQfllzR+lfmlN6me2hmpyaHKAg==","signatures":[{"sig":"MEUCIQCZrr/ko9nYyIR7pab4OhUIlHL/4o4MzLG0Sq8NOLgyNwIgQ6e4w/UHt9H948t8QapnrHxZG7geQeshVuZ2WJLm4jU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":125188},"main":"build/index.js","types":"./build/index.d.ts","engines":{"npm":">=8.0.0","node":"18.x"},"gitHead":"fc06acafd31a195cff41478c18d72b8c975b231b","scripts":{"dev":"cross-env PORT=3002 IS_LOCAL=true NODE_ENV=development TZ='UTC' nodemon","test":"node --test test/*.test.js","build":"tsc","start":"node build/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"syama.sundara","email":"syama.sundara@aot-technologies.com"},"_npmVersion":"11.4.2","description":"BambooHR MCP Server","directories":{},"_nodeVersion":"20.18.3","dependencies":{"zod":"^3.24.2","cors":"^2.8.5","axios":"^1.8.4","dotenv":"^16.5.0","express":"^4.18.2","cross-env":"^7.0.3","@types/cors":"^2.8.19","@modelcontextprotocol/sdk":"^1.11.0"},"_hasShrinkwrap":false,"devDependencies":{"shx":"^0.4.0","tsx":"^4.7.0","nodemon":"^3.1.0","typescript":"^5.3.3","@types/node":"^18.19.0","@types/express":"^4.17.21"},"_npmOperationalInternal":{"tmp":"tmp/bamboohr-mcp-server_1.0.4_1760601159531_0.35619039258154217","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2025-09-12T08:08:07.048Z","modified":"2026-03-23T06:53:03.262Z","1.0.0":"2025-09-12T08:08:07.339Z","1.0.1":"2025-09-12T08:27:54.006Z","1.0.2":"2025-09-12T08:52:47.715Z","1.0.3":"2025-10-16T06:21:03.867Z","1.0.4":"2025-10-16T07:52:39.707Z"},"author":{"name":"K Syama"},"license":"MIT","keywords":["mcp","bamboohr","typescript","hr"],"description":"BambooHR MCP Server","maintainers":[{"email":"syama.sundara@aot-technologies.com","name":"syama.sundara"},{"email":"hasgar.d@aot-technologies.com","name":"hasgar-aot"}],"readme":"# BambooHR MCP Server\r\n\r\nA Model Context Protocol (MCP) server for interacting with BambooHR's API.\r\n\r\n## Features\r\n\r\n### Employee Management\r\n- **Get All Employees**: Retrieve a list of all employees with customizable fields\r\n- **Get Employee Details**: Get detailed information about a specific employee\r\n- **Create Employee**: Add new employees to the system\r\n- **Update Employee**: Modify existing employee information\r\n\r\n### Time Off Management\r\n- **Get Time Off Requests**: List time off requests with filtering options\r\n- **Create Time Off Request**: Submit new time off requests\r\n- **Update Time Off Request**: Approve, deny, or cancel time off requests\r\n- **Get Time Off Balance**: Check employee time off balances\r\n\r\n## Installation\r\n\r\n```bash\r\nnpm install\r\nnpm run build\r\n```\r\n\r\n## Configuration\r\n\r\nCreate a `.env` file based on `.env.example`:\r\n\r\n```env\r\nBAMBOOHR_COMPANY_DOMAIN=your_company_subdomain\r\nBAMBOOHR_BEARER_TOKEN=your_api_token\r\n```\r\n\r\n### Getting Your API Token\r\n\r\n1. Log into BambooHR as an administrator\r\n2. Click your profile picture in the upper right corner\r\n3. Choose \"API Keys\"\r\n4. Click \"Add New Key\"\r\n5. Give it a name and click \"Generate Key\"\r\n6. Copy the API key immediately (you won't be able to see it again)\r\n\r\n## Usage\r\n\r\n### As an MCP Server\r\n\r\n```bash\r\nnpm start\r\n```\r\n\r\n### Development Mode\r\n\r\n```bash\r\nnpm run dev\r\n```\r\n\r\n## Available Tools\r\n\r\n### Employee Tools\r\n\r\n#### bamboohr_get_all_employees\r\nGet all employees with specified fields.\r\n\r\nParameters:\r\n- `fields` (optional): Array of field names to retrieve\r\n\r\n#### bamboohr_get_employee\r\nGet detailed information about a specific employee.\r\n\r\nParameters:\r\n- `employeeId`: The unique ID of the employee\r\n\r\n#### bamboohr_create_employee\r\nCreate a new employee.\r\n\r\nParameters:\r\n- `firstName`: Employee's first name\r\n- `lastName`: Employee's last name\r\n- `email` (optional): Email address\r\n- `department` (optional): Department name\r\n- `jobTitle` (optional): Job title\r\n- `hireDate` (optional): Hire date (YYYY-MM-DD)\r\n- `supervisorId` (optional): Supervisor's employee ID\r\n- `location` (optional): Work location\r\n- `workPhone` (optional): Work phone number\r\n\r\n#### bamboohr_update_employee\r\nUpdate an existing employee's information.\r\n\r\nParameters:\r\n- `employeeId`: The unique ID of the employee\r\n- All other parameters from create (optional)\r\n\r\n### Time Off Tools\r\n\r\n#### bamboohr_get_time_off_requests\r\nGet time off requests with filtering options.\r\n\r\nParameters:\r\n- `employeeId` (optional): Filter by employee\r\n- `startDate` (optional): Start date (YYYY-MM-DD)\r\n- `endDate` (optional): End date (YYYY-MM-DD)\r\n- `status` (optional): Filter by status\r\n\r\n#### bamboohr_create_time_off_request\r\nCreate a new time off request.\r\n\r\nParameters:\r\n- `employeeId`: Employee ID\r\n- `start`: Start date (YYYY-MM-DD)\r\n- `end`: End date (YYYY-MM-DD)\r\n- `timeOffTypeId`: Time off type ID\r\n- `amount`: Amount of time off\r\n- `unit`: 'days' or 'hours'\r\n- `notes` (optional): Request notes\r\n\r\n#### bamboohr_update_time_off_request\r\nUpdate a time off request status.\r\n\r\nParameters:\r\n- `requestId`: Request ID\r\n- `status`: 'approved', 'denied', or 'canceled'\r\n- `note` (optional): Decision note\r\n\r\n#### bamboohr_get_time_off_balance\r\nGet time off balance for an employee.\r\n\r\nParameters:\r\n- `employeeId`: Employee ID\r\n\r\n## License\r\n\r\nMIT","readmeFilename":"README.md"}