@schoox/schoox-mcp-server

MCP server for querying Schoox LMS data via AI assistants.

Connect your AI assistant to your Schoox academy and use natural language to query users, courses, enrollments, progress, events, and more -- without writing API code.

<video src="https://github.com/user-attachments/assets/0dfb79fb-06da-4716-8a59-b25e7075b706" width="100%" autoplay loop muted></video>

Prerequisites

• Node.js 18+ (download)
• Schoox API key and Academy ID (available from your Schoox academy admin settings)

Quick Start

Claude Desktop

Add to your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "schoox": {
      "command": "/usr/local/bin/npx",
      "args": ["-y", "@schoox/schoox-mcp-server"],
      "env": {
        "SCHOOX_API_KEY": "your-api-key",
        "SCHOOX_ACADEMY_ID": "123456"
      }
    }
  }
}

Note: Claude Desktop uses a minimal PATH. If you use nvm or Volta, run which npx to find your full path and replace /usr/local/bin/npx above.

Claude Code

Add to ~/.claude.json (global, all projects) or .mcp.json in your project root (project-level):

{
  "mcpServers": {
    "schoox": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@schoox/schoox-mcp-server"],
      "env": {
        "SCHOOX_API_KEY": "your-api-key",
        "SCHOOX_ACADEMY_ID": "123456"
      }
    }
  }
}

Or use the CLI:

claude mcp add schoox -e SCHOOX_API_KEY=your-api-key -e SCHOOX_ACADEMY_ID=123456 -- npx -y @schoox/schoox-mcp-server

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "schoox": {
      "command": "npx",
      "args": ["-y", "@schoox/schoox-mcp-server"],
      "env": {
        "SCHOOX_API_KEY": "your-api-key",
        "SCHOOX_ACADEMY_ID": "123456"
      }
    }
  }
}

Other MCP Clients

Any MCP-compatible client can use the standard stdio configuration:

{
  "mcpServers": {
    "schoox": {
      "command": "npx",
      "args": ["-y", "@schoox/schoox-mcp-server"],
      "env": {
        "SCHOOX_API_KEY": "your-api-key",
        "SCHOOX_ACADEMY_ID": "123456"
      }
    }
  }
}

Example

Once configured, ask your AI assistant questions like:

"Show me all active courses in my academy"

"How many users completed the Safety Training course this month?"

"List all events scheduled for next week"

The assistant uses the Schoox MCP tools automatically to fetch data from your academy and respond in natural language.

Available Tools

Tool	Description
aboves	Look up organizational hierarchy levels above units (regions, divisions, areas, districts)
badges	List available badges configured in the academy
content	Browse content items (web resources, uploaded files, SCORM packages) and metadata
courses	Query the course catalog, course details, skills, students, lectures, and exams
curriculums	Query learning paths (curricula) -- structured training programs
dashboard	Training analytics and progress reporting (per-user and aggregate)
events	Query instructor-led training (ILT) and virtual classroom (VC) events
exams	Query exam metadata and student exam results/scores
groups	List user groups configured in the academy
jobs	List job roles defined in the academy
skills	Query skill/competency definitions, assessments, and relationships
types	List custom type definitions configured in academy settings
units	Look up organizational units (stores, locations, departments)
usage	Get academy-wide usage and licensing summary statistics
users	Look up user profiles and badges

Configuration

All configuration is via environment variables:

Variable	Required	Default	Description
SCHOOX_API_KEY	Yes	--	Schoox API key from academy settings
SCHOOX_ACADEMY_ID	Yes	--	Numeric academy ID from Schoox admin dashboard
SCHOOX_MAX_RECORDS	No	1000	Maximum records per paginated request
SCHOOX_BASE_URL	No	https://api.schoox.com/v1	API base URL

License

MIT