Skip to main content

BambooHR

BambooHR hosts an MCP server for each company at https://{companyDomain}.bamboohr.com/api/mcp. Each person signs in with their own BambooHR account. BambooHR does not register clients automatically. An admin creates an application in the developer portal, requests the mcp scope, and pastes the client ID and secret into Willow. It is the BambooHR card with the Official badge. Willow also has a built-in BambooHR connector.

Before you start​

  • An active BambooHR account, and the company subdomain (the part before .bamboohr.com).
  • A developer-portal account at developers.bamboohr.com. Applications are created there, not inside the BambooHR product.
  • The AI Connectors app enabled by a BambooHR admin when your client is covered by that gate. BambooHR is extending that gate to MCP clients in general.

Set up BambooHR​

  1. In the developer portal, add an application and name it, for example Willow.
  2. Set the redirect URI to the URI from Willow's setup step. It must match exactly.
  3. Request the mcp scope, plus the entity scopes the tools need (for example employees, time off, payroll, benefits). The mcp scope grants access to the server. Entity scopes limit the data.
  4. Copy the Client ID and Client Secret. The secret is shown once. Regenerating it invalidates the previous secret.

Access tokens last one hour. Willow refreshes them. The server cannot grant access the signed-in user does not already have.

Set up Willow​

  1. Go to MCP Servers → + Add MCP server, open the BambooHR card with the Official badge, and click + Use.
  2. Enter the company subdomain.
  3. Keep OAuth sign-in. Paste the Client ID and Client Secret.
  4. Click Check connection and sign in. Assign groups and Publish.

Troubleshooting​

The redirect is rejected​

Cause: The redirect URI in the developer portal does not match Willow, including a trailing slash or capitalization.

Solution: Copy the URI from Willow's setup step and paste it into the application. Do not retype it.

Additional Resources​