plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "bamboohr-workspace-url",
  "version": "1.0.0",
  "description": "BambooHR connects an assistant to a company's own BambooHR account so people can ask about their employee record, time off, goals, and coworkers, and get real answers back instead of opening the BambooHR web app. Employees can check their own balances, request time off, track goals, and look up the company directory. Managers can additionally review and approve or deny their direct reports' time off and manage their goals. Administrators can operate across the full employee population: applicant tracking, saved reports and datasets, company files, and (where BambooHR's Global Employment add-on is enabled) EOR and contractor data from Remote. The connector introduces no separate permission model of its own — every call is scoped by the caller's real BambooHR access level, so it can never show or change more than the signed-in user could already see or change in BambooHR itself.",
  "author": {
    "name": "BambooHR",
    "url": "https://www.bamboohr.com"
  },
  "homepage": "https://www.bamboohr.com",
  "keywords": [
    "hr",
    "time off",
    "employees",
    "reports",
    "goals",
    "hiring"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "BambooHR",
        "shortDescription": "Connect BambooHR to ChatGPT",
        "longDescription": "BambooHR connects an assistant to a company's own BambooHR account so people can ask about their employee record, time off, goals, and coworkers, and get real answers back instead of opening the BambooHR web app. Employees can check their own balances, request time off, track goals, and look up the company directory. Managers can additionally review and approve or deny their direct reports' time off and manage their goals. Administrators can operate across the full employee population: applicant tracking, saved reports and datasets, company files, and (where BambooHR's Global Employment add-on is enabled) EOR and contractor data from Remote. The connector introduces no separate permission model of its own — every call is scoped by the caller's real BambooHR access level, so it can never show or change more than the signed-in user could already see or change in BambooHR itself.",
        "developerName": "BambooHR",
        "category": "Business & Operations",
        "capabilities": [
          "Read",
          "Write"
        ],
        "websiteURL": "https://www.bamboohr.com",
        "supportURL": "https://www.bamboohr.com/about-bamboohr/contact/",
        "privacyPolicyURL": "https://www.bamboohr.com/legal/",
        "termsOfServiceURL": "https://www.bamboohr.com/legal/terms-of-service",
        "defaultPrompt": [
          "Who's out this week?",
          "Show me headcount by department.",
          "Update my Q2 launch goal to 75% complete."
        ],
        "brandColor": "#73C41D",
        "composerIcon": "./assets/composer-icon-96px.png",
        "logo": "./assets/directory-icon-256px.png"
      },
      "review": {
        "demo_recording_url": "https://bamboohr.wistia.com/s/3g5fhoy72gemz1e",
        "commerce": false,
        "test_cases": {
          "positive": [
            {
              "description": "Look up a coworker in the company directory.",
              "prompt": "What's Whitney Webster's job title and department?",
              "tools_triggered": "get_employees_directory",
              "expected_behavior": "The matching directory entry's published fields (title, department, location), scoped to what the caller is allowed to see."
            },
            {
              "description": "Check the caller's own remaining time-off balance.",
              "prompt": "How many vacation days do I have left this year?",
              "tools_triggered": "get_time_off_balance",
              "expected_behavior": "A breakdown by time-off type showing accrued, used, and remaining balance for the authenticated user."
            },
            {
              "description": "Review the caller's own goals.",
              "prompt": "What goals do I currently have?",
              "tools_triggered": "list_goals",
              "expected_behavior": "A list of the caller's own goal records: title, status, due date, and current progress percentage."
            },
            {
              "description": "List the time-off types the company offers.",
              "prompt": "What types of time off does my company offer?",
              "tools_triggered": "list_time_off_types",
              "expected_behavior": "The company's active time-off types (for example vacation and sick) with each type's default daily hours."
            },
            {
              "description": "Check who is out of the office over an upcoming period.",
              "prompt": "Who's out of the office this week?",
              "tools_triggered": "list_whos_out",
              "expected_behavior": "A date-sorted list of out-of-office employees and any company holidays in that window."
            }
          ],
          "negative": [
            {
              "description": "Do not trigger for a general calendar/scheduling question unrelated to BambooHR data.",
              "prompt": "What meetings do I have on my calendar tomorrow?",
              "expected_behavior": "The app should not be invoked; meeting calendars are outside its supported HR workflows."
            },
            {
              "description": "Do not trigger for a payroll question the connector has no tool to answer.",
              "prompt": "What was my last paycheck amount after taxes?",
              "expected_behavior": "The app should not be invoked, or if invoked should clearly state it cannot access payroll/pay-stub data rather than guessing."
            },
            {
              "description": "Do not let a caller without report-running permission see fabricated data.",
              "prompt": "Run the \"Employee List\" saved report for the whole company.",
              "tools_triggered": "get_report_by_id",
              "expected_behavior": "For a caller without report-running permission, the tool's underlying call is rejected and the assistant reports that the user does not have permission, rather than fabricating report data."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "Introducing the BambooHR connector for ChatGPT\n\nConnect BambooHR to ChatGPT to answer people questions and complete common HR tasks without interrupting your workflow.\n\nWith the BambooHR connector, you can:\n- Look up employee details, reporting relationships, job history, tenure, and anniversaries.\n- Check who’s out, review PTO balances, and submit or approve time-off requests.\n- Run saved reports or ask ad hoc questions such as headcount by department or recent hires.\n- Review job openings and applicants, track pipeline status, and add application notes.\n- Create and update goals, milestones, and progress.\n- Access global employment information—including workers, onboarding tasks, and supported hiring countries—when your company uses BambooHR’s employer-of-record offering.\n\nTry asking:\n- “Who’s out this week?”\n- “Show me headcount by department.”\n- “Who has applied for the Senior Product Manager role?”\n- “Update my Q2 launch goal to 75% complete.”\n\nA BambooHR administrator must first enable AI Connectors under Settings → Apps and choose who may connect. Users then sign in securely with OAuth. Every request respects the connected user’s existing BambooHR permissions, and some capabilities depend on the products and settings enabled for their company.\nLearn how to connect BambooHR to ChatGPT: https://documentation.bamboohr.com/docs/chatgpt-connector"
      }
    }
  }
}