claudegoodies
Skill

canvas

From NousResearch

Canvas LMS integration — fetch enrolled courses and assignments using API token authentication.

Fetches Canvas LMS course and assignment lists via a Python CLI using an API token.

Use it when

  • Listing enrolled courses (active or all states) from Canvas
  • Pulling assignments and due dates for a specific course ID
  • Need JSON output of course/assignment data for other tooling

Skip it if

  • You need to submit, grade, or modify anything — it's read-only
  • You don't have a Canvas API token or admin access to generate one
  • Your institution isn't on Canvas LMS

Facts

Repository
NousResearch/hermes-agent
Status
Actively maintained
Last commit
Source file
optional-skills/productivity/canvas/SKILL.md

Source preview

The instructions Claude Code reads when this skill runs.

# Canvas LMS — Course & Assignment Access

Read-only access to Canvas LMS for listing courses and assignments.

## Scripts

- `scripts/canvas_api.py` — Python CLI for Canvas API calls

## Setup

1. Log in to your Canvas instance in a browser
2. Go to **Account → Settings** (click your profile icon, then Settings)
3. Scroll to **Approved Integrations** and click **+ New Access Token**
4. Name the token (e.g., "Hermes Agent"), set an optional expiry, and click **Generate Token**
5. Copy the token and add to `${HERMES_HOME:-~/.hermes}/.env`:

```
CANVAS_API_TOKEN=your_token_here
CANVAS_BASE_URL=https://yourschool.instructure.com
```

The base URL is whatever appears in your browser when you're logged into Canvas (no trailing slash).

## Usage

```bash
CANVAS="python $HERMES_HOME/skills/productivity/canvas/scripts/canvas_api.py"

# List all active courses
$CANVAS list_courses --enrollment-state active

# List all courses (any state)
$CANVAS list_courses

# List assignments for a specific course
$CANVAS list_assignments 12345

# List assignments ordered by due date
$CANVAS list_assignments 12345 --order-by due_at
```

## Output Format

**list_courses** returns:
```json
[{"id": 12345, "name": "Intro to CS", "course_code": "CS101", "workflow_state": "available", "start_at": "...", "end_at": "..."}]
```

**list_assignments** returns:
```json
[{"id": 67890, "name": "Homework 1", "due_at
View full source on GitHub →

Other skills