WorkRamp MCP Server

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.

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.