Skip to main content
Glama

BambooHR MCP Server

by evrimalacan
MIT License

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

  1. Log into your BambooHR account
  2. Click your name in the lower left-hand corner of any page
  3. Select API Keys from the user context menu (if you have sufficient permissions)
  4. Generate a new API key
  5. Note your company subdomain (the part before .bamboohr.com)

Configuration

Add the server to your Claude Desktop configuration:

{ "mcpServers": { "bamboohr": { "command": "npx", "args": ["mcp-bamboohr@latest"], "type": "stdio", "env": { "BAMBOO_API_TOKEN": "your_actual_api_token", "BAMBOO_COMPANY_DOMAIN": "your_company_subdomain" } } } }

✨ 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 fields
  • get-employee-photo - Download employee photos in various sizes
  • get-employee-directory - Access the complete company directory
  • get-employee-goals - View performance goals and objectives

Time Off Management

  • estimate-time-off-balance - Calculate future time off balances
  • get-time-off-requests - Retrieve and filter time off requests
  • get-whos-out - View upcoming time off and holidays

Company Resources

  • list-company-files - Browse available company files and categories
  • get-company-file - Download specific company documents
  • get-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

# Clone and setup git clone https://github.com/evrimalacan/mcp-bamboohr.git cd mcp-bamboohr npm install # Build npm run build # Run tests (71 comprehensive tests with 100% coverage) npm test # Development mode npm run dev

🐛 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

🤝 Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Add tests for your changes
  4. Ensure all tests pass (npm test)
  5. Commit your changes (git commit -m 'Add amazing feature')
  6. Push to the branch (git push origin feature/amazing-feature)
  7. Open a Pull Request

📄 License

MIT License - see LICENSE file for details.

🌟 Support


Made with tons of ❤️

-
security - not tested
A
license - permissive license
-
quality - not tested

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.

  1. 🚀 Quick Start
    1. Get Your BambooHR Credentials
    2. Configuration
  2. ✨ Features
    1. 🛠️ Available Tools
      1. Employee Management
      2. Time Off Management
      3. Company Resources
    2. 💡 Example Queries
      1. 🏗️ Development
        1. From Source
      2. 🐛 Troubleshooting
        1. Common Issues
      3. 📚 Documentation
        1. 🤝 Contributing
          1. 📄 License
            1. 🌟 Support

              Related MCP Servers

              • A
                security
                F
                license
                A
                quality
                Enables 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 -
              • -
                security
                F
                license
                -
                quality
                Enables 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 -
                • Apple
              • A
                security
                A
                license
                A
                quality
                Provides 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 -
                2
                7
                MIT License
                • Apple
                • Linux
              • A
                security
                A
                license
                A
                quality
                Enables 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 -
                22
                5
                MIT License

              View all related MCP servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/evrimalacan/mcp-bamboohr'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server