BambooHR MCP Server
A Model Context Protocol (MCP) server that seamlessly connects AI assistants to BambooHR's API. Access employee data, time off information, company files, and more through natural language queries in Claude and other AI assistants.
🚀 Quick Start
Get Your BambooHR Credentials
- Log into your BambooHR account
- Click your name in the lower left-hand corner of any page
- Select API Keys from the user context menu (if you have sufficient permissions)
- Generate a new API key
- Note your company subdomain (the part before
.bamboohr.com
)
Configuration
Add the server to your Claude Desktop configuration:
✨ Features
- 🧑💼 Employee Management - Get employee data, photos, directory, and performance goals
- 🏖️ Time Off Management - Check balances, requests, and who's out
- 📁 Company Resources - Access files, documents, and metadata
- 🔒 Token Authentication - Uses BambooHR's API with token authentication
- 🎯 Type Safety - Full TypeScript support with type definitions
- ✅ 100% Test Coverage - 71 tests covering all code
- 🛡️ Error Handling - Proper error handling and timeouts
- 📚 Documentation - Setup guides and examples
🛠️ Available Tools
The server provides 10 MCP tools covering essential BambooHR operations:
Employee Management
get-employee
- Retrieve detailed employee information with customizable fieldsget-employee-photo
- Download employee photos in various sizesget-employee-directory
- Access the complete company directoryget-employee-goals
- View performance goals and objectives
Time Off Management
estimate-time-off-balance
- Calculate future time off balancesget-time-off-requests
- Retrieve and filter time off requestsget-whos-out
- View upcoming time off and holidays
Company Resources
list-company-files
- Browse available company files and categoriesget-company-file
- Download specific company documentsget-meta-fields
- Discover all available BambooHR data fields
💡 Example Queries
- "Show me John Smith's employee information"
- "Who's out of office next week?"
- "What are the pending time off requests that need approval?"
- "Download the employee handbook from company files"
- "What are Sarah's current performance goals?"
- "How much vacation time will I have by year-end?"
🏗️ Development
From Source
🐛 Troubleshooting
Common Issues
"Authentication failed"
- Verify your API token is correct
- Ensure company domain is just the subdomain (not full URL)
"Access forbidden"
- Check your BambooHR user has API access enabled
- Verify permissions for the specific resource
"Resource not found"
- Confirm the employee ID or resource exists
- Check you have permission to access the resource
📚 Documentation
- Complete Usage Guide - Detailed setup, configuration, and usage
- BambooHR API Documentation - Official API reference
🤝 Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature
) - Add tests for your changes
- Ensure all tests pass (
npm test
) - Commit your changes (
git commit -m 'Add amazing feature'
) - Push to the branch (
git push origin feature/amazing-feature
) - Open a Pull Request
📄 License
MIT License - see LICENSE file for details.
🌟 Support
- 🐛 Bug Reports: GitHub Issues
- 💡 Feature Requests: GitHub Discussions
- 📖 Documentation: See CLAUDE.md for comprehensive guide
Made with tons of ❤️
This server cannot be installed
Enables AI assistants to interact with BambooHR's API through natural language queries. Provides access to employee data, time off management, company files, and HR operations with comprehensive tools for workforce management.
Related MCP Servers
- AsecurityFlicenseAqualityEnables interaction with the Loxo recruitment platform API, facilitating tasks such as candidate and job management, activity logging, and call queue management through AI assistants.Last updated -
- -securityFlicense-qualityEnables AI assistants to interact with Metabase, providing access to dashboards, questions, databases, and tools for executing queries and viewing data through natural language.Last updated -
- AsecurityAlicenseAqualityProvides tools to interact with the HireBase Job API, enabling users to search for jobs using various criteria and retrieve detailed job information through natural language.Last updated -27MIT License
- AsecurityAlicenseAqualityEnables AI clients to seamlessly take HubSpot actions and interact with HubSpot data, allowing users to create/update CRM records, manage associations, and gain insights through natural language.Last updated -225MIT License