canvas-lms - SKILL.md Agent Skill

name: canvas-lms description: Access Canvas LMS (Instructure) for course data, assignments, grades, and submissions. Use when checking due dates, viewing grades, listing courses, or fetching course materials from Canvas.

Canvas LMS Skill

Access Canvas LMS data via the REST API.

Setup

Credentials are preconfigured. Use the values below directly.

Authentication

Use these values directly in all curl commands — do NOT use source or environment variables:

# Token and URL — use these literal values:
CANVAS_TOKEN="YOUR_CANVAS_API_TOKEN"
CANVAS_URL="https://vinuni.instructure.com"

# Example call:
curl -s --max-time 30 -H "Authorization: Bearer YOUR_CANVAS_API_TOKEN" "https://vinuni.instructure.com/api/v1/users/self/profile"

Common Endpoints

Courses & Profile

# User profile
curl -s --max-time 30 -H "Authorization: Bearer YOUR_CANVAS_API_TOKEN" "https://vinuni.instructure.com/api/v1/users/self/profile"

# Active courses
curl -s --max-time 30 -H "Authorization: Bearer YOUR_CANVAS_API_TOKEN" "https://vinuni.instructure.com/api/v1/courses?enrollment_state=active&per_page=50"

# Dashboard cards
curl -s --max-time 30 -H "Authorization: Bearer YOUR_CANVAS_API_TOKEN" "https://vinuni.instructure.com/api/v1/dashboard/dashboard_cards"

Assignments & Due Dates

# To-do items
curl -s --max-time 30 -H "Authorization: Bearer YOUR_CANVAS_API_TOKEN" "https://vinuni.instructure.com/api/v1/users/self/todo"

# Upcoming events
curl -s --max-time 30 -H "Authorization: Bearer YOUR_CANVAS_API_TOKEN" "https://vinuni.instructure.com/api/v1/users/self/upcoming_events"

# Missing/overdue submissions
curl -s --max-time 30 -H "Authorization: Bearer YOUR_CANVAS_API_TOKEN" "https://vinuni.instructure.com/api/v1/users/self/missing_submissions"

# Course assignments (replace COURSE_ID)
curl -s --max-time 30 -H "Authorization: Bearer YOUR_CANVAS_API_TOKEN" "https://vinuni.instructure.com/api/v1/courses/{course_id}/assignments?per_page=50"

# Submission status
curl -s --max-time 30 -H "Authorization: Bearer YOUR_CANVAS_API_TOKEN" "https://vinuni.instructure.com/api/v1/courses/{course_id}/assignments/{id}/submissions/self"

Grades

# Enrollments with scores
curl -s --max-time 30 -H "Authorization: Bearer YOUR_CANVAS_API_TOKEN" "https://vinuni.instructure.com/api/v1/users/self/enrollments?include[]=current_grading_period_scores&per_page=50"

Extract grade: .grades.current_score

Course Content

# Announcements
curl -s --max-time 30 -H "Authorization: Bearer YOUR_CANVAS_API_TOKEN" "https://vinuni.instructure.com/api/v1/announcements?context_codes[]=course_{course_id}&per_page=20"

# Modules
curl -s --max-time 30 -H "Authorization: Bearer YOUR_CANVAS_API_TOKEN" "https://vinuni.instructure.com/api/v1/courses/{course_id}/modules?include[]=items&per_page=50"

# Files
curl -s --max-time 30 -H "Authorization: Bearer YOUR_CANVAS_API_TOKEN" "https://vinuni.instructure.com/api/v1/courses/{course_id}/files?per_page=50"

# Discussion topics
curl -s --max-time 30 -H "Authorization: Bearer YOUR_CANVAS_API_TOKEN" "https://vinuni.instructure.com/api/v1/courses/{course_id}/discussion_topics?per_page=50"

# Inbox
curl -s --max-time 30 -H "Authorization: Bearer YOUR_CANVAS_API_TOKEN" "https://vinuni.instructure.com/api/v1/conversations?per_page=20"

Response Handling

List endpoints return arrays
Pagination: check Link header for rel="next"
Dates are ISO 8601 (UTC)
Use --max-time 30 for slow endpoints

Parse with jq:

curl -s ... | jq '.[] | {name: .name, due: .due_at}'

Or Python if jq unavailable:

curl -s ... | python3 -c "import sys,json; data=json.load(sys.stdin); print(json.dumps(data, indent=2))"

Tips

Course IDs appear in todo/assignment responses
File download URLs are in the url field of file objects
Always include per_page=50 to get more results (default is often 10)