BambooHR MCP Apps

Overview

18 standalone React MCP apps built for the BambooHR MCP server. Each app is self-contained with its own directory structure and can be run independently.

Apps Built

Employee Management

employee-dashboard (Port 3000)
- Overview with headcount, new hires, turnover stats
- Recent time off requests and active goals
- Key metrics and activity cards
employee-detail (Port 3001)
- Full employee profile with job info
- Compensation details and review dates
- Custom fields and contact information
employee-directory (Port 3002)
- Searchable/filterable employee grid
- Filter by department and status
- Contact information display

Time Off Management

time-off-calendar (Port 3003)
- Visual calendar of time-off requests
- Monthly view with navigation
- Color-coded status (approved/pending/denied)
time-off-requests (Port 3004)
- Request list with approve/deny actions
- Status badges (pending/approved/denied)
- Filterable by status
time-off-balances (Port 3005)
- Balance overview per employee/policy
- Vacation, sick, and personal day tracking
- Progress bars showing usage

Reporting & Analytics

report-builder (Port 3006)
- Custom report configuration interface
- Drag-and-drop field selection
- Export format options (CSV/Excel/PDF)
headcount-analytics (Port 3015)
- Headcount trends over time
- Department breakdown
- Growth rate calculations
turnover-report (Port 3016)
- Turnover metrics and analysis
- Voluntary vs involuntary breakdown
- Exit reasons and department risk levels

Benefits & Payroll

benefits-overview (Port 3007)
- Benefits plans with enrollment counts
- Coverage statistics
- Plan comparisons
benefits-enrollment (Port 3008)
- Employee enrollment details
- Plan selections by employee
- Enrollment status tracking
payroll-dashboard (Port 3009)
- Pay stub overview
- Deduction summary and breakdown
- YTD earnings and tax documents

Development & Goals

goal-tracker (Port 3010)
- Employee goals with progress bars
- Status tracking (on track/at risk/completed)
- Goals grouped by employee
training-catalog (Port 3011)
- Training courses with completion tracking
- Course ratings and difficulty levels
- Enrollment statistics
training-progress (Port 3012)
- Per-employee training status
- Completion rates
- Hours completed tracking

Organization & Onboarding

file-manager (Port 3013)
- Employee documents browser
- File categorization
- Upload/download functionality (UI)
org-chart (Port 3014)
- Organizational hierarchy visualization
- Expandable/collapsible tree view
- Direct reports display
new-hires (Port 3017)
- Recent hires onboarding tracker
- Onboarding progress tracking
- Scheduled vs in-progress status

Technical Details

Structure

Each app directory contains:

App.tsx - Main React component
index.html - HTML entry point with Tailwind CDN
vite.config.ts - Vite configuration with unique port

Theme

Dark theme using Tailwind CSS
Primary colors: #0f172a (slate-900) and #1e293b (slate-800)
Gradient accents: blue-to-purple for progress indicators
Color-coded status badges

Components

Self-contained apps with inline shared components
Card component for consistent layout
Client-side state management with React hooks
Lucide React icons throughout

Development

To run any app:

cd src/ui/react-app/{app-name}
npm install
npm run dev

Each app runs on its own port (3000-3017) to avoid conflicts.

Total Stats

18 apps created
54 files (3 per app)
~3,626 lines of code
Dark theme throughout
Responsive design with Tailwind CSS

3.9 KiB Raw Blame History