KnowBe4 MCP Server

A Model Context Protocol (MCP) server for KnowBe4 security awareness training. Enables AI assistants to manage phishing simulations, training campaigns, user risk scoring, and security awareness reporting.

This is a Model Context Protocol (MCP) server that connects Claude (or any MCP-compatible AI) to your KnowBe4 environment.

Part of the MSP Claude Plugins ecosystem — a growing suite of AI integrations for the MSP stack. Built by MSPs, for MSPs.

Installation

npm install @wyre-technology/knowbe4-mcp

Configuration

Set the following environment variables:

Variable	Required	Description
KNOWBE4_API_KEY	Yes	Your KnowBe4 API key
KNOWBE4_REGION	No	API region: us, eu, ca, uk, de (default: us)
KNOWBE4_BASE_URL	No	Custom base URL (overrides region)
MCP_TRANSPORT	No	Transport mode: stdio (default) or http

Usage

Running with Claude Desktop

Add to your Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "knowbe4-mcp": {
      "command": "npx",
      "args": ["@wyre-technology/knowbe4-mcp"],
      "env": {
        "KNOWBE4_API_KEY": "your-knowbe4-api-key"
      }
    }
  }
}

Running with Claude Code (CLI)

claude mcp add knowbe4-mcp \
  -e KNOWBE4_API_KEY=your-value \
  -- npx -y @wyre-technology/knowbe4-mcp

Docker

docker build -t knowbe4-mcp .
docker run \
  -e KNOWBE4_API_KEY=your-value \
  -p 8080:8080 knowbe4-mcp

Available Domains

Account

Account information and settings

Groups

User group management

Phishing

Phishing simulation campaigns

Reporting

Security awareness reports

Training

Training campaign management

Users

User management and risk scoring

Development

# Clone the repository
git clone https://github.com/wyre-technology/knowbe4-mcp.git
cd knowbe4-mcp

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

Contributing

Contributions are welcome! Please see CONTRIBUTING.md if present, or open an issue to discuss changes.

License

Licensed under the Apache License, Version 2.0. See LICENSE for details.