Content
# WorkRamp MCP Server
An [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server for the [WorkRamp](https://www.workramp.com/) 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.
[](https://modelcontextprotocol.io/)
[](https://www.workramp.com/)
[](https://www.python.org/)
[](LICENSE)
> 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
```bash
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`:
```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](LICENSE) — 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.
