Boooply MCP Server

The official Model Context Protocol server for Boooply AI Interviews. Let AI assistants like Claude, Cursor, and VS Code Copilot manage interviews through natural language.

Setup

No installation needed — runs directly via npx.

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "boooply": {
      "command": "npx",
      "args": ["-y", "@boooply/mcp-server@latest"],
      "env": {
        "BOOOPLY_API_KEY": "bply_...",
        "BOOOPLY_API_URL": "https://api.meetings.boooply.com"
      }
    }
  }
}

Claude Code

Add to .claude/settings.json or ~/.claude/settings.json:

{
  "mcpServers": {
    "boooply": {
      "command": "npx",
      "args": ["-y", "@boooply/mcp-server@latest"],
      "env": {
        "BOOOPLY_API_KEY": "bply_...",
        "BOOOPLY_API_URL": "https://api.meetings.boooply.com"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "boooply": {
      "command": "npx",
      "args": ["-y", "@boooply/mcp-server@latest"],
      "env": {
        "BOOOPLY_API_KEY": "bply_...",
        "BOOOPLY_API_URL": "https://api.meetings.boooply.com"
      }
    }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "boooply": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@boooply/mcp-server@latest"],
      "env": {
        "BOOOPLY_API_KEY": "bply_...",
        "BOOOPLY_API_URL": "https://api.meetings.boooply.com"
      }
    }
  }
}

Getting Your API Key

Get your API key from the Boooply dashboard under Integrations > REST API & SDK.

Available Tools (13)

Interview Management

| Tool | Description | |------|-------------| | create_ai_interview | Create an AI-conducted interview with configurable skills, questions, and evaluation focus | | create_human_interview | Create a video interview with human interviewers. Supports CANDIDATE_PICKS scheduling | | create_team_meeting | Create an internal team meeting with transcription and AI-generated notes | | list_interviews | List interviews with filtering by status, type, and search | | get_interview | Get full details of an interview by meeting code | | cancel_interview | Cancel a scheduled interview | | reschedule_interview | Reschedule an interview to a new time |

Results & Analysis

| Tool | Description | |------|-------------| | get_evaluation | Get AI-generated scores, summary, strengths, and recommendations | | get_transcript | Get the full conversation transcript with speaker attribution | | trigger_analysis | Re-run AI analysis on a completed interview |

Calendar & Availability

| Tool | Description | |------|-------------| | get_availability | Get available time slots from an interviewer's Google Calendar connected in Boooply | | get_busy_blocks | Get raw busy time blocks from an interviewer's calendar for custom scheduling logic |

AI Features

| Tool | Description | |------|-------------| | generate_job_description | Generate a professional job description using AI |

Example Prompts

"Create an AI interview for [email protected] for Senior React Developer,
 focus on technical knowledge, 25 minutes"

"Check Bob's availability for next week — he's at [email protected], 45-minute slots"

"List all completed interviews from this week"

"Get the evaluation for Boooply-AI-1234567890"

"Schedule a human interview with [email protected] and let her pick a time
 from [email protected]'s calendar"

Scheduling Modes

| Mode | Available For | Description | |------|--------------|-------------| | IMMEDIATE | AI, Human, Team | Starts right away | | FIXED | AI, Human, Team | Scheduled for a specific datetime | | CANDIDATE_PICKS | AI, Human only | Candidate receives a booking link to choose a time |

SSE Mode

For web-based MCP clients:

BOOOPLY_API_KEY=bply_... BOOOPLY_API_URL=https://api.meetings.boooply.com npx -y @boooply/mcp-server@latest --sse

Documentation

• SDK Documentation
• API Reference
• Webhook Events
• MCP Guide

Related

• @boooply/ai-interviews-sdk — Node.js SDK for programmatic access

License

MIT