Workramp

An MCP (Model Context Protocol) server for the WorkRamp LMS API. It lets Claude (and any other MCP-compatible client) operate your WorkRamp instance in plain English — enroll users, assign learning paths, audit certifications, and query your content catalog without clicking through the admin UI or writing API calls by hand.

MCP WorkRamp LMS Python License: MIT

Turn "which sales reps haven't finished the Q3 compliance path?" into an answer Claude pulls straight from WorkRamp. If it saves you a trip through the admin console, ⭐ star the repo.

Features

30 tools across 9 categories:

• Connection — test API connectivity
• Users & Groups — list, create, update users; manage groups
• Guides — list courses, manage assignments
• Paths — list learning paths, manage assignments
• Content — browse content catalog, item folders
• Certifications — list certs, view awards
• Resources & SCORM — list resources and SCORM courses
• Events — list instructor-led events
• Academy — external learner portal (contacts, trainings, collections, registrations)

Setup

1. Clone and install

git clone https://github.com/msdanyg/workramp-mcp.git
cd workramp-mcp
python3 -m venv venv
source venv/bin/activate
pip install -e .

2. Get your API token

Generate a token from your WorkRamp admin console (Settings > API). This is a Bearer token, not OAuth.

3. Configure for Claude Code

Add to ~/.mcp.json:

{
  "mcpServers": {
    "workramp": {
      "command": "/path/to/workramp-mcp/venv/bin/python",
      "args": ["-m", "workramp_mcp.server"],
      "env": {
        "WORKRAMP_API_TOKEN": "your-token-here",
        "WORKRAMP_BASE_URL": "https://app.workramp.com",
        "WORKRAMP_ACADEMY_ID": ""
      }
    }
  }
}

4. Configure for Claude Desktop

Add the same entry to ~/Library/Application Support/Claude/claude_desktop_config.json under mcpServers.

Environment Variables

Variable	Required	Description
WORKRAMP_API_TOKEN	Yes	Bearer token from WorkRamp admin console
WORKRAMP_BASE_URL	No	Defaults to https://app.workramp.com. Use https://app.eu.workramp.com for EU accounts
WORKRAMP_ACADEMY_ID	No	Required only for Academy (external learner) endpoints

API Notes

• Auth: Bearer token in header (no OAuth)
• Rate limits: 3,000/hour sustained, 13,000/hour burst (auto-retry on 429)
• Pagination: Supported on list endpoints via page/per_page params
• Timestamps: Mix of UNIX milliseconds and ISO8601

License

MIT — use it, fork it, adapt it.

Disclaimer

This is an independent, community-built integration and is not affiliated with, endorsed by, or supported by WorkRamp. "WorkRamp" is a trademark of its respective owner. Use your own API credentials and comply with WorkRamp's API terms.