# How to connect Bamboohr to Muse ```json { "title": "How to connect Bamboohr to Muse", "toolkit": "Bamboohr", "toolkit_slug": "bamboohr", "framework": "Muse", "framework_slug": "muse", "url": "https://composio.dev/toolkits/bamboohr/framework/muse", "markdown_url": "https://composio.dev/toolkits/bamboohr/framework/muse.md", "updated_at": "2026-10-04T16:47:20.950Z" } ``` ## Introduction Muse is Meta's AI assistant. It can connect to outside tools through custom connectors, which use the Model Context Protocol (MCP). This guide explains how to connect Bamboohr to Muse using Composio Connect, which handles OAuth, token refresh, and reliability so you do not have to. You add Composio as a custom connector once, then ask Muse to work with Bamboohr in plain language. ## Also integrate Bamboohr with - [Claude Code](https://composio.dev/toolkits/bamboohr/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/bamboohr/framework/claude-cowork) - [OpenAI Agents SDK](https://composio.dev/toolkits/bamboohr/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/bamboohr/framework/claude-agents-sdk) - [Codex](https://composio.dev/toolkits/bamboohr/framework/codex) - [OpenClaw](https://composio.dev/toolkits/bamboohr/framework/openclaw) - [Hermes](https://composio.dev/toolkits/bamboohr/framework/hermes-agent) - [Atomic Agent](https://composio.dev/toolkits/bamboohr/framework/atomic-agent) - [Google ADK](https://composio.dev/toolkits/bamboohr/framework/google-adk) - [LangChain](https://composio.dev/toolkits/bamboohr/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/bamboohr/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/bamboohr/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/bamboohr/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/bamboohr/framework/crew-ai) - [Pydantic AI](https://composio.dev/toolkits/bamboohr/framework/pydantic-ai) - [AutoGen](https://composio.dev/toolkits/bamboohr/framework/autogen) ## TL;DR - Cross-app workflows across 1,500+ apps from a single plugin layer. - On-demand tool loading so Muse only loads the tools needed for the current task. - Programmatic tool calling through a remote workbench for complex, multi-step workflows. - Multi-account support so users can connect and switch between multiple accounts for the same app. - Shared account access so teams or agents can work through common business accounts and service connections. - Managed authentication with OAuth handling, credential storage, and token refresh managed by Composio. - Safer credential handling so app credentials stay outside the model context and tool responses. - User-level account isolation so actions run against the correct connected account instead of mixing user access. ## Connect Bamboohr to Muse ### Connecting Bamboohr to Muse You add Composio to Muse once as a custom connector, then connect Bamboohr from the chat. ## What is the Bamboohr MCP server, and what's possible with it? The BambooHR MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your BambooHR account. It provides structured and secure access to employee records, hiring data, time off, benefits, reports, and company files, so your agent can manage employees, track candidates, submit time off requests, run reports, and organize HR documents on your behalf. - Employee records and organization: Have your agent retrieve or create employee records, find recent employee changes, and review departments, divisions, locations, job titles, and employment statuses. - Hiring and candidate management: Direct your agent to create job openings and candidate applications, list applications, check applicant statuses, and review hiring leads or job summaries. - Time off administration: Let the agent submit time off requests, review requests within a date range, check employee balances, and inspect available time off types and policies. - Reports, benefits, and company data: Instruct your agent to run company reports, review benefit coverages and member events, or retrieve company information and tax identifiers. - HR files and employee details: Have your agent list or upload company files, create file categories, retrieve employee photos and custom fields, or add and review employee dependents. ## Supported Tools | Tool slug | Name | Description | |---|---|---| | `BAMBOOHR_ATS_CREATE_CANDIDATE` | Create Candidate Application | Tool to create a candidate application. Use when adding a new applicant to a specific job opening in BambooHR ATS. | | `BAMBOOHR_ATS_CREATE_JOB_OPENING` | Create Job Opening | Tool to create a new job opening in BambooHR ATS. Use when you need to open a new job for applicants. | | `BAMBOOHR_ATS_GET_APPLICATIONS` | List Job Applications | Tool to list job applications with optional filters. Use when retrieving ATS applications for reporting or integration. | | `BAMBOOHR_BENEFIT_GET_COVERAGES` | Get Benefit Coverages | Tool to retrieve standard benefit coverage options. Use when you need to fetch all or specific coverages before configuring benefit plans. | | `BAMBOOHR_BENEFIT_GET_MEMBER_EVENTS` | Get Member Benefit Events | Tool to list member benefit events. Use when you need to fetch all benefit events visible to the authenticated user. | | `BAMBOOHR_COMPANY_GET_EINS` | Get Company EINs | Tool to retrieve company Employer Identification Numbers (EINs). Use when you need to fetch your account's EINs after authenticating. | | `BAMBOOHR_COMPANY_GET_INFORMATION` | Get Company Information | Tool to retrieve company information. Use when you need details about the current account's settings. | | `BAMBOOHR_CREATE_FILE_CATEGORY` | Create File Category | Tool to create new company file categories. Use when organizing company files by adding new categories after confirming desired names. | | `BAMBOOHR_CREATE_TIME_OFF_REQUEST` | Create Time Off Request | Tool to submit a new time off request. Use after confirming employee ID and valid payload. | | `BAMBOOHR_DATASETS_LIST` | List Datasets | Tool to list available datasets via the Datasets API. Use when you need to discover available dataset schemas before querying data. | | `BAMBOOHR_DEPENDENTS_CREATE` | Create Employee Dependent | Tool to add a dependent to an employee. Use when a new dependent needs to be recorded for benefits or HR tracking. Ensure the employee record exists before calling this tool. | | `BAMBOOHR_DEPENDENTS_GET_ALL` | Get All Employee Dependents | Tool to retrieve all employee dependents. Use after ensuring your API key has access to benefit settings. | | `BAMBOOHR_EMPLOYEE_CREATE` | Create Employee | Tool to create a new employee record. Use when adding employees via BambooHR API. Returns the new employee's ID. | | `BAMBOOHR_EMPLOYEE_FILES_CREATE_CATEGORY` | Create Employee File Category | Tool to create new employee file categories. Use when organizing employee files by adding new categories after confirming desired names. | | `BAMBOOHR_EMPLOYEE_GET_CHANGED` | Get Changed Employees | Tool to get employees inserted, updated, or deleted since a given timestamp. Use when fetching incremental HR changes. | | `BAMBOOHR_FILES_LIST` | List Company Files | Tool to list company file categories and their files. Use when you need to retrieve all company files organized by category after confirming file inventory exists. | | `BAMBOOHR_FILES_UPLOAD` | Upload Company File | Tool to upload a new company file. Use when you need to add a file to BambooHR after confirming its category and share settings. | | `BAMBOOHR_GET_ALL_EMPLOYEES` | Get All Employees | Retrieves all employees from the BambooHR employee directory including their basic information and status. | | `BAMBOOHR_GET_APPLICANT_STATUSES` | Get Applicant Statuses | Tool to retrieve applicant statuses. Use when you need to list ATS statuses for your company; requires ATS settings access. | | `BAMBOOHR_GET_CUSTOM_EMPLOYEE_FIELDS` | Get Custom Employee Fields | Tool to fetch custom employee field values. Use when you need to retrieve only custom fields for all employees. | | `BAMBOOHR_GET_CUSTOM_REPORTS` | Run Custom Report | Tool to run a custom report by ID or ad-hoc fields. Use when you need to execute a saved report or generate an ad-hoc report and retrieve its results in JSON or file format. | | `BAMBOOHR_GET_EMPLOYEE` | Get Employee | Tool to retrieve detailed information for a specific employee. Use when you need individual employee data by ID. | | `BAMBOOHR_GET_EMPLOYEE_PHOTO` | Get Employee Photo | Tool to retrieve an employee's profile photo by size. Use when you need to download the image binary for the specified employee after confirming their ID. | | `BAMBOOHR_GET_HIRING_LEADS` | Get Hiring Leads | Tool to retrieve potential hiring leads (employees who can manage job openings) for use in creating a new job opening. The API key owner must have access to ATS settings. | | `BAMBOOHR_GET_JOB_SUMMARIES` | Get Job Summaries | Tool to retrieve a list of ATS job summaries. Use when you need an overview of all job postings and their key details. | | `BAMBOOHR_GET_META_DEPARTMENTS` | Get Departments Metadata | Tool to list department metadata. Use after needing all available department codes and names. | | `BAMBOOHR_GET_META_DIVISIONS` | Get Meta Divisions | Tool to list all division metadata. Use after authenticating to fetch the account's divisions. | | `BAMBOOHR_GET_META_EMPLOYMENT_STATUSES` | List Employment Status Metadata | Tool to list all employment status metadata. Use when you need all defined employment statuses for the company. | | `BAMBOOHR_GET_META_JOB_TITLES` | Get Meta Job Titles | Tool to retrieve job title metadata. Uses the list-field metadata endpoint and extracts the options for the `jobTitle` field. | | `BAMBOOHR_GET_META_LOCATIONS` | Get Meta Locations | Tool to list location metadata. Use when you need all configured company locations for lookups. | | `BAMBOOHR_GET_META_TIME_OFF_TYPES` | Get Time-Off Types Metadata | Tool to list time-off type metadata. Use when you need to discover available time-off types before creating time-off requests. | | `BAMBOOHR_GET_REPORT` | Get Report | Tool to fetch a built-in or published report in JSON or other formats. Use when you need to retrieve report data or download report files after specifying the report ID and desired output format. | | `BAMBOOHR_GET_TIME_OFF_BALANCES` | Get Time-Off Balances | Tool to retrieve time-off balances for employees. Use when you need current balances across your team. | | `BAMBOOHR_GET_TIME_OFF_REQUESTS` | Get Time-Off Requests | Tool to list time-off requests within a date range. Use after confirming start and end dates; supports optional filters for status, employee, and time off type. | | `BAMBOOHR_LIST_BUILTIN_REPORTS` | List Company Reports | Tool to list all available company and custom reports. Use after confirming account setup. Requires 'report' scope for OAuth or an API key with report access permissions. | | `BAMBOOHR_META_GET_COUNTRIES` | Get Country Options | Tool to retrieve all available country options. Use when you need a complete list of selectable countries before updating or validating country fields. | | `BAMBOOHR_META_GET_LIST_FIELD_DETAILS` | Get List Field Details | Tool to get details for all list fields. Use when you need to discover list field options before using them. | | `BAMBOOHR_META_GET_TABULAR_FIELDS` | Get Tabular Fields Metadata | Tool to list tabular table fields metadata. Use when you need standard table structures before accessing table rows. | | `BAMBOOHR_META_GET_USERS` | Get Users | Tool to list active users with basic info. Use when you need to retrieve current users' IDs, names, and emails. | | `BAMBOOHR_UPDATE_EMPLOYEE` | Update Employee | Tool to update fields on a specified employee record. Use when you need to modify employee properties via BambooHR API after confirming the target employee ID. Example: "Update employee 12345's department to Sales". | | `BAMBOOHR_UPDATE_TIME_OFF_REQUEST` | Update Time Off Request | Tool to update the status of an existing time-off request. Use when you need to approve, deny, or cancel a request after reviewing it. Example: "Approve time-off request 12345". | ## Supported Triggers None listed. ## Troubleshooting ### 1. Why doesn't Muse show a button to add my API key? Muse shows the button only when you ask it to open the secure credentials store. - Start a new chat. - Send the message from step 1 exactly as written. - If Muse asks for the key in the chat, do not paste it. Ask Muse to open the secure credentials store. ### 2. Why does the Composio connection fail after I add my API key? The key or the connector settings are not correct. - Copy the full key from the Composio dashboard. It starts with ck_. - Make sure the URL is https://connect.composio.dev/mcp and the header is x-consumer-api-key. - Remove the Composio connector in Muse settings, then do steps 1 to 3 again. ### 3. Why doesn't Muse use the Composio tools for Bamboohr? Muse may not pick the Composio connector for the request. - Ask Muse to list its Composio tools. - Name Composio and Bamboohr in your request, for example: Use Composio to connect to Bamboohr. - If it still does not work, start a new chat and try again. ### 4. Why does Muse ask me to connect Bamboohr again? Your Bamboohr connection expired or was removed. - Open the link Muse gives you and sign in to Bamboohr again. - Check that the Bamboohr connection shows as ACTIVE in the Composio dashboard. ### 5. What do I do if I pasted my API key into the chat? Treat the key as exposed. - Create a new API key in the Composio dashboard and delete the old one. - Add the new key in Muse's secure credentials store, not in the chat. ## Creating MCP Server - Stand-alone vs Composio SDK Once connected, Muse can access the Bamboohr MCP server through Composio to run the actions you authorize, using plain language in the chat. ## Complete Code None listed. ## Conclusion ### Way Forward Now that Bamboohr is connected, extend your setup by connecting the other apps you already use every day, so Muse can run true cross-app workflows end to end. - Connect Calendar to turn threads into scheduled meetings automatically. - Connect Slack or Teams to post summaries, approvals, and alerts where your team works. - Connect Notion, Linear, Jira, or Asana to convert requests into tickets, tasks, and docs. - Connect Drive, Dropbox, or OneDrive to fetch, file, and share attachments without manual steps. Start with one workflow you do repeatedly, then keep adding apps as you find new handoffs. With everything behind a single connection, Muse can coordinate multiple tools safely and reliably in one conversation. ## How to build Bamboohr MCP Agent with another framework - [Claude Code](https://composio.dev/toolkits/bamboohr/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/bamboohr/framework/claude-cowork) - [OpenAI Agents SDK](https://composio.dev/toolkits/bamboohr/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/bamboohr/framework/claude-agents-sdk) - [Codex](https://composio.dev/toolkits/bamboohr/framework/codex) - [OpenClaw](https://composio.dev/toolkits/bamboohr/framework/openclaw) - [Hermes](https://composio.dev/toolkits/bamboohr/framework/hermes-agent) - [Atomic Agent](https://composio.dev/toolkits/bamboohr/framework/atomic-agent) - [Google ADK](https://composio.dev/toolkits/bamboohr/framework/google-adk) - [LangChain](https://composio.dev/toolkits/bamboohr/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/bamboohr/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/bamboohr/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/bamboohr/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/bamboohr/framework/crew-ai) - [Pydantic AI](https://composio.dev/toolkits/bamboohr/framework/pydantic-ai) - [AutoGen](https://composio.dev/toolkits/bamboohr/framework/autogen) ## Related Toolkits - [Ashby](https://composio.dev/toolkits/ashby) - Ashby is an applicant tracking system that handles job postings, candidate management, and hiring analytics. - [7shifts](https://composio.dev/toolkits/7shifts) - 7shifts is a restaurant team management platform for scheduling, time clocks, payroll, and team communication. It helps operators keep labor, shifts, and staff workflows organized in one place. - [Breathe HR](https://composio.dev/toolkits/breathehr) - Breathe HR is cloud-based HR software for SMEs to manage employee data, absences, and performance. It simplifies HR admin, making it easy to keep employee records accurate and up to date. - [Breezy Hr](https://composio.dev/toolkits/breezy_hr) - Breezy HR is a recruiting and applicant tracking platform for managing jobs, candidates, pipelines, and hiring teams. It helps teams move faster from job posting to offer without losing track of applicants. - [Connecteam](https://composio.dev/toolkits/connecteam) - Connecteam is a workforce management platform for deskless teams, streamlining operations, HR, and team communication. It helps businesses save time by automating scheduling, time tracking, and staff engagement tasks. - [ContactOut](https://composio.dev/toolkits/contactout) - ContactOut is a professional profile enrichment and contact discovery API. Find and verify email addresses to power recruiting, sales, and outreach. - [Coresignal](https://composio.dev/toolkits/coresignal) - Coresignal is a real-time public web data platform for employee, company, and professional profile intelligence. It helps teams access fresh workforce data for research, recruiting, sales, and market analysis. - [Dice MCP](https://composio.dev/toolkits/dice_mcp) - Dice MCP is an MCP server for searching Dice's tech-job database by role, company, location, and employment type. It helps agents find relevant tech roles fast with conversational filters. - [Greenhouse](https://composio.dev/toolkits/greenhouse) - Greenhouse is applicant tracking and recruiting software for managing jobs, candidates, interviews, and hiring workflows. It helps recruiting teams move faster with structured pipelines, collaboration tools, and hiring data in one place. - [Gusto](https://composio.dev/toolkits/gusto) - Gusto is a payroll, benefits, and HR platform for small and medium businesses. It helps teams run payroll, manage people, and stay compliant with less busywork. - [Hireflix](https://composio.dev/toolkits/hireflix) - Hireflix is a one-way video interview platform for hiring teams. It helps teams manage positions, candidate interviews, templates, and branded hiring workflows in one place. - [Job Search (Rapid API)](https://composio.dev/toolkits/job_search) - Job Search (Rapid API) is a unified service that searches approved job-listing sources via RapidAPI hosts. Use it to aggregate and query listings across providers with a single API. - [Lever](https://composio.dev/toolkits/lever) - Lever is an applicant tracking system that blends sourcing, CRM, and analytics for recruiting. It helps companies scale hiring with collaborative workflows and actionable insights. - [Personio](https://composio.dev/toolkits/personio) - Personio is an HR platform for managing employee records, attendance, absences, projects, and documents. It centralizes HR data and streamlines workforce administration for teams and HR leaders. - [Recruitee](https://composio.dev/toolkits/recruitee) - Recruitee is collaborative hiring software that centralizes recruitment tasks for teams. It streamlines sourcing, interviewing, and hiring so you can fill roles faster. - [Remote retrieval](https://composio.dev/toolkits/remote_retrieval) - Remote retrieval is a logistics automation tool for managing laptop and monitor returns. It streamlines return tracking, saving time and hassle for IT and ops teams. - [Sap successfactors](https://composio.dev/toolkits/sap_successfactors) - Sap successfactors is a cloud-based human capital management suite for HR, payroll, recruiting, and talent management. It helps organizations centralize employee data and streamline the entire employee lifecycle. - [Talenthr](https://composio.dev/toolkits/talenthr) - TalentHR is an intuitive, all-in-one HR tool for managing employee records, leave, and HR workflows. It streamlines HR operations so businesses can focus on people, not paperwork. - [Web3 Career](https://composio.dev/toolkits/web3_career) - Web3 Career is a job listings service focused on blockchain, crypto, and decentralized technology. It helps you find roles with filters for technology, role, location, and remote options. - [Workable](https://composio.dev/toolkits/workable) - Workable is an all-in-one HR software platform that streamlines hiring, employee management, and payroll. It helps teams simplify recruiting, onboarding, and staff operations in one place. ## Frequently Asked Questions ### Does Muse support MCP? Yes. Muse supports custom connectors that use the Model Context Protocol (MCP). Composio connects as one custom connector over remote streamable HTTP at https://connect.composio.dev/mcp, and gives Muse access to Bamboohr and 1,500+ other apps. ### Where do I get the API key for the Composio connector? Copy it from the Composio dashboard. It starts with ck_. Enter it only in Muse's secure credentials store, never in the chat. ### Can I connect more than one Bamboohr account to Muse? Yes. Composio supports multiple connected accounts for the same app. Give each Bamboohr connection a name, such as work or personal, and tell Muse which one to use. ### How safe is my Bamboohr data with Composio? Tokens, keys, and configuration are encrypted at rest and in transit. Your Composio API key stays in Muse's secure credentials store, not in the chat or the model context. Composio is SOC 2 Type 2 compliant. --- [See all toolkits](https://composio.dev/toolkits) ยท [Composio docs](https://docs.composio.dev/llms.txt)