> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Canvas LMS

The Canvas LMS connector lets your AI agent act in each user's Canvas LMS account. Each user connects their own Canvas LMS access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 30 tools.

**Authentication:** Bearer Token
**Categories:** Productivity, Collaboration
**Tools:** 30: 20 read, 10 write, 0 destructive
**Users sign in with:** Access token
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=CANVASLMS)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Canvas LMS connection

   In **AgentKit > Connections**, create a Canvas LMS connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'canvaslms'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Canvas LMS:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'canvaslms_calendar_event_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "canvaslms"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Canvas LMS:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="canvaslms_calendar_event_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Canvas LMS credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'canvaslms_announcement_list',
  toolInput: {
    context_codes: ['course_1234', 'course_5678'],
  },
  connector: 'canvaslms',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="canvaslms_announcement_list",
    tool_input={
        "context_codes": ["course_1234", "course_5678"],
    },
    connection_name="canvaslms",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `canvaslms_announcement_list`

List Announcements · Read-only

List announcements from one or more Canvas courses within a date range.
Returns an array of announcements with id, title, message, posted_at, context_code, author and html_url.
Use canvaslms_announcement_list for recent announcements across courses. Use canvaslms_discussion_topic_list with only_announcements for one course without a date window.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `context_codes` (`array`, required): Courses to read, as course_<id> codes. Example: ["course_1234", "course_5678"].
- `active_only` (`boolean`, optional): Only published, active announcements. Example: true.
- `end_date` (`string`, optional): Latest posted date, yyyy-mm-dd or ISO 8601. Defaults to 28 days after start_date. Example: 2026-11-30.
- `latest_only` (`boolean`, optional): Return at most one (the latest) announcement per course. Example: true.
- `page` (`string`, optional): Page of results to return, starting at 1. Request the next page while a full page comes back. Example: 2.
- `per_page` (`integer`, optional): Number of results per page (Canvas default 10, max usually 100). Example: 50.
- `start_date` (`string`, optional): Earliest posted date, yyyy-mm-dd or ISO 8601. Defaults to 14 days ago. Example: 2026-11-01.

Example input: `{"context_codes":["course_1234","course_5678"]}`

### `canvaslms_assignment_get`

Get Assignment · Read-only

Get one assignment in a Canvas course.
Returns id, name, description, due_at, unlock_at, lock_at, points_possible, grading_type, submission_types, rubric, published and html_url.
Use canvaslms_assignment_get when you have an assignment ID. Use canvaslms_assignment_list to find it.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `assignment_id` (`string`, required): ID of the assignment, from canvaslms_assignment_list. Example: 9012.
- `course_id` (`string`, required): ID of the course. Get it from canvaslms_course_list (the id field) or from the course URL /courses/<id>. You can also pass an SIS ID as sis_course_id:<id>. Example: 1234.
- `include` (`array`, optional): Extra data. Allowed: submission, assignment_visibility, overrides, observed_users, can_edit, score_statistics. Example: ["submission"].

Example input: `{"assignment_id":"<assignment_id>","course_id":"<course_id>"}`

### `canvaslms_assignment_list`

List Assignments · Read-only

List the assignments in a Canvas course, optionally filtered by a title search or a due-date bucket.
Returns an array of assignments with id, name, description, due_at, points_possible, submission_types, published, html_url and, when requested, the caller's submission.
Use canvaslms_assignment_list to browse or find assignment IDs. Use canvaslms_assignment_get for one assignment.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `course_id` (`string`, required): ID of the course. Get it from canvaslms_course_list (the id field) or from the course URL /courses/<id>. You can also pass an SIS ID as sis_course_id:<id>. Example: 1234.
- `bucket` (`string`, optional): Only return assignments in this due-date bucket, relative to the calling user. Allowed: past, overdue, undated, ungraded, unsubmitted, upcoming, future. Example: upcoming. One of: `past`, `overdue`, `undated`, `ungraded`, `unsubmitted`, `upcoming`, `future`.
- `include` (`array`, optional): Extra data. Allowed: submission, assignment_visibility, all_dates, overrides, observed_users, can_edit, score_statistics. Example: ["submission"].
- `order_by` (`string`, optional): Sort order. Allowed: position (default), name, due_at. Example: due_at. One of: `position`, `name`, `due_at`.
- `page` (`string`, optional): Page of results to return, starting at 1. Request the next page while a full page comes back. Example: 2.
- `per_page` (`integer`, optional): Number of results per page (Canvas default 10, max usually 100). Example: 50.
- `search_term` (`string`, optional): Partial assignment title to match. Example: essay.

Example input: `{"course_id":"<course_id>"}`

### `canvaslms_calendar_event_list`

List Calendar Events · Read-only

List calendar events or assignment due dates for the user or for given courses within a date range.
Returns an array of events with id, title, description, start_at, end_at, location_name, context_code, html_url and, for assignments, the nested assignment.
Use canvaslms_calendar_event_list for a schedule of what is coming up. Use canvaslms_assignment_list for one course's assignments.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `all_events` (`boolean`, optional): Return all events and ignore the date range. Example: false.
- `context_codes` (`array`, optional): Calendars to read, up to 10, such as course_1234 or user_5678. Defaults to the user's own calendar. Example: ["course_1234"].
- `end_date` (`string`, optional): End of the range, yyyy-mm-dd or ISO 8601. Defaults to start_date. Example: 2026-11-30.
- `page` (`string`, optional): Page of results to return, starting at 1. Request the next page while a full page comes back. Example: 2.
- `per_page` (`integer`, optional): Number of results per page (Canvas default 10, max usually 100). Example: 50.
- `start_date` (`string`, optional): Start of the range, yyyy-mm-dd or ISO 8601. Defaults to today. Example: 2026-11-15.
- `type` (`string`, optional): event (default) for calendar events or assignment for assignment due dates. Example: assignment. One of: `event`, `assignment`, `sub_assignment`.
- `undated` (`boolean`, optional): Return only undated events. Example: false.

Example input: `{}`

### `canvaslms_conversation_get`

Get Conversation · Read-only

Get one Canvas inbox conversation with all its messages.
Returns id, subject, participants and a messages array with id, author_id, body, created_at and attachments.
Use canvaslms_conversation_get to read a thread. Use canvaslms_conversation_message_add to reply.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `conversation_id` (`string`, required): ID of the conversation, from canvaslms_conversation_list. Example: 2468.
- `auto_mark_as_read` (`boolean`, optional): Mark the conversation as read. Defaults to true. Example: false. Default: `true`.

Example input: `{"conversation_id":"<conversation_id>"}`

### `canvaslms_conversation_list`

List Conversations · Read-only

List the authenticated user's Canvas inbox conversations, optionally limited to unread, starred, archived or sent.
Returns an array of conversations with id, subject, workflow_state, last_message, last_message_at, message_count, participants and context_name.
Use canvaslms_conversation_list to browse the inbox. Use canvaslms_conversation_get to read a conversation's messages.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `filter` (`array`, optional): Only conversations with these users or courses, as user_<id> or course_<id>. Example: ["course_1234"].
- `page` (`string`, optional): Page of results to return, starting at 1. Request the next page while a full page comes back. Example: 2.
- `per_page` (`integer`, optional): Number of results per page (Canvas default 10, max usually 100). Example: 50.
- `scope` (`string`, optional): Which conversations. Allowed: unread, starred, archived, sent. Omit for the inbox. Example: unread. One of: `unread`, `starred`, `archived`, `sent`.

Example input: `{}`

### `canvaslms_course_get`

Get Course · Read-only

Get one Canvas course by ID.
Returns id, name, course_code, workflow_state, start_at, end_at, default_view, time_zone and any requested include fields such as syllabus_body, term or teachers.
Use canvaslms_course_get when you already have a course ID. Use canvaslms_course_list to find it.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `course_id` (`string`, required): ID of the course. Get it from canvaslms_course_list (the id field) or from the course URL /courses/<id>. You can also pass an SIS ID as sis_course_id:<id>. Example: 1234.
- `include` (`array`, optional): Extra data to add, such as syllabus_body, term, teachers, total_students, sections, permissions or course_progress. Example: ["syllabus_body", "term"].

Example input: `{"course_id":"<course_id>"}`

### `canvaslms_course_list`

List Courses · Read-only

List the courses the authenticated user is enrolled in, optionally filtered by enrollment type, enrollment state or course state.
Returns an array of courses with id, name, course_code, workflow_state, start_at, end_at, enrollments and any requested include fields.
Use canvaslms_course_list to find course IDs for every other tool. Use canvaslms_course_get for one course's full details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `enrollment_state` (`string`, optional): Only return courses where the user's enrollment is in this state. Allowed: active, invited_or_pending, completed. Example: active. One of: `active`, `invited_or_pending`, `completed`.
- `enrollment_type` (`string`, optional): Only return courses where the user has this enrollment type. Allowed: teacher, student, ta, observer, designer. Example: teacher. One of: `teacher`, `student`, `ta`, `observer`, `designer`.
- `include` (`array`, optional): Extra data to add to each course, such as term, teachers, total_students, syllabus_body, total_scores, needs_grading_count, course_progress, sections or favorites. Example: ["term", "total_students"].
- `page` (`string`, optional): Page of results to return, starting at 1. Request the next page while a full page comes back. Example: 2.
- `per_page` (`integer`, optional): Number of results per page (Canvas default 10, max usually 100). Example: 50.
- `state` (`array`, optional): Only return courses in these states. Allowed: unpublished, available, completed, deleted. Example: ["available"].

Example input: `{}`

### `canvaslms_course_user_list`

List Course Users · Read-only

List or search the users in a Canvas course, optionally filtered by enrollment type or a name search.
Returns an array of users with id, name, sortable_name, short_name, login_id and, when requested, their enrollments.
Use canvaslms_course_user_list to find a student's or teacher's user ID by name. Use canvaslms_enrollment_list for enrollment records with grades and states.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `course_id` (`string`, required): ID of the course. Get it from canvaslms_course_list (the id field) or from the course URL /courses/<id>. You can also pass an SIS ID as sis_course_id:<id>. Example: 1234.
- `enrollment_state` (`array`, optional): Only return users whose enrollment is in these states. Allowed: active, invited, rejected, completed, inactive. Example: ["active"].
- `enrollment_type` (`array`, optional): Only return users with these enrollment types. Allowed: teacher, student, student_view, ta, observer, designer. Example: ["student"].
- `include` (`array`, optional): Extra data per user. Allowed: enrollments, locked, avatar_url, test_student, bio, custom_links, current_grading_period_scores, uuid. Example: ["enrollments", "avatar_url"].
- `page` (`string`, optional): Page of results to return, starting at 1. Request the next page while a full page comes back. Example: 2.
- `per_page` (`integer`, optional): Number of results per page (Canvas default 10, max usually 100). Example: 50.
- `search_term` (`string`, optional): Partial name or full ID to match users against. Example: jane.
- `sort` (`string`, optional): Field to sort by. Allowed: username, last_login, email, sis_id. Example: username. One of: `username`, `last_login`, `email`, `sis_id`.

Example input: `{"course_id":"<course_id>"}`

### `canvaslms_discussion_topic_get`

Get Discussion Topic · Read-only

Get one discussion topic or announcement in a Canvas course.
Returns id, title, message, author, posted_at, discussion_type, published, locked, pinned, require_initial_post and discussion_subentry_count.
Use canvaslms_discussion_topic_get for the topic itself. Use canvaslms_discussion_entry_create to reply.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `course_id` (`string`, required): ID of the course. Get it from canvaslms_course_list (the id field) or from the course URL /courses/<id>. You can also pass an SIS ID as sis_course_id:<id>. Example: 1234.
- `topic_id` (`string`, required): ID of the discussion topic or announcement, from canvaslms_discussion_topic_list. Example: 3456.

Example input: `{"course_id":"<course_id>","topic_id":"<topic_id>"}`

### `canvaslms_discussion_topic_list`

List Discussion Topics · Read-only

List the discussion topics in a Canvas course, or its announcements when only_announcements is true.
Returns an array of topics with id, title, message, posted_at, last_reply_at, discussion_subentry_count, published, pinned, locked and html_url.
Use canvaslms_discussion_topic_list to browse one course's discussions. Use canvaslms_announcement_list for announcements across several courses by date.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `course_id` (`string`, required): ID of the course. Get it from canvaslms_course_list (the id field) or from the course URL /courses/<id>. You can also pass an SIS ID as sis_course_id:<id>. Example: 1234.
- `filter_by` (`string`, optional): all (default) or unread. Example: unread. One of: `all`, `unread`.
- `only_announcements` (`boolean`, optional): Return announcements instead of discussion topics. Defaults to false. Example: true.
- `order_by` (`string`, optional): Sort order. Allowed: position (default), recent_activity, title. Example: recent_activity. One of: `position`, `recent_activity`, `title`.
- `page` (`string`, optional): Page of results to return, starting at 1. Request the next page while a full page comes back. Example: 2.
- `per_page` (`integer`, optional): Number of results per page (Canvas default 10, max usually 100). Example: 50.
- `scope` (`string`, optional): Comma-separated filters from locked, unlocked, pinned, unpinned. Example: unlocked.
- `search_term` (`string`, optional): Partial title to match. Example: midterm.

Example input: `{"course_id":"<course_id>"}`

### `canvaslms_enrollment_list`

List Enrollments · Read-only

List the enrollments in a Canvas course, optionally filtered by type, state or user.
Returns an array of enrollments with id, user_id, type, enrollment_state, role, course_section_id, the nested user and, for students, grades (current_score, final_score, current_grade).
Use canvaslms_enrollment_list to see who is enrolled in which role and to read students' course grades. Use canvaslms_course_user_list to search users by name.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `course_id` (`string`, required): ID of the course. Get it from canvaslms_course_list (the id field) or from the course URL /courses/<id>. You can also pass an SIS ID as sis_course_id:<id>. Example: 1234.
- `include` (`array`, optional): Extra data. Allowed: avatar_url, group_ids, locked, observed_users, can_be_removed, uuid, current_points. Example: ["current_points"].
- `page` (`string`, optional): Page of results to return, starting at 1. Request the next page while a full page comes back. Example: 2.
- `per_page` (`integer`, optional): Number of results per page (Canvas default 10, max usually 100). Example: 50.
- `state` (`array`, optional): Only return enrollments in these states. Allowed: active, invited, creation_pending, deleted, rejected, completed, inactive. Defaults to active and invited. Example: ["active"].
- `type` (`array`, optional): Only return these enrollment types. Allowed: StudentEnrollment, TeacherEnrollment, TaEnrollment, DesignerEnrollment, ObserverEnrollment. Example: ["StudentEnrollment"].
- `user_id` (`string`, optional): Only return enrollments for this user ID. Example: 5678.

Example input: `{"course_id":"<course_id>"}`

### `canvaslms_module_item_list`

List Module Items · Read-only

List the items in one module of a Canvas course.
Returns an array of items with id, title, type (Assignment, Page, Discussion, File, Quiz, ExternalUrl and others), content_id, page_url, html_url, position and completion_requirement.
Use canvaslms_module_item_list after canvaslms_module_list to open a module's contents.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `course_id` (`string`, required): ID of the course. Get it from canvaslms_course_list (the id field) or from the course URL /courses/<id>. You can also pass an SIS ID as sis_course_id:<id>. Example: 1234.
- `module_id` (`string`, required): ID of the module, from canvaslms_module_list. Example: 77.
- `include` (`array`, optional): Extra data. Allowed: content_details. Example: ["content_details"].
- `page` (`string`, optional): Page of results to return, starting at 1. Request the next page while a full page comes back. Example: 2.
- `per_page` (`integer`, optional): Number of results per page (Canvas default 10, max usually 100). Example: 50.
- `search_term` (`string`, optional): Partial item title to match. Example: quiz.
- `student_id` (`string`, optional): Return this student's completion information for each item. Example: 5678.

Example input: `{"course_id":"<course_id>","module_id":"<module_id>"}`

### `canvaslms_module_list`

List Modules · Read-only

List the modules in a Canvas course, optionally with their items.
Returns an array of modules with id, name, position, unlock_at, state (for students), items_count, published and, when requested, items.
Use canvaslms_module_list to see how a course is organised. Use canvaslms_module_item_list for one module's items.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `course_id` (`string`, required): ID of the course. Get it from canvaslms_course_list (the id field) or from the course URL /courses/<id>. You can also pass an SIS ID as sis_course_id:<id>. Example: 1234.
- `include` (`array`, optional): Extra data. Allowed: items (the module's items), content_details (needs items). Example: ["items"].
- `page` (`string`, optional): Page of results to return, starting at 1. Request the next page while a full page comes back. Example: 2.
- `per_page` (`integer`, optional): Number of results per page (Canvas default 10, max usually 100). Example: 50.
- `search_term` (`string`, optional): Partial module name to match (also matches item titles when include has items). Example: week 3.
- `student_id` (`string`, optional): Return this student's completion information for each module. Example: 5678.

Example input: `{"course_id":"<course_id>"}`

### `canvaslms_page_get`

Get Page · Read-only

Get one wiki page in a Canvas course, including its HTML body.
Returns page_id, url, title, body, published, front_page, editing_roles, updated_at and last_edited_by.
Use canvaslms_page_get to read a page's content. Use canvaslms_page_list to find its url slug.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `course_id` (`string`, required): ID of the course. Get it from canvaslms_course_list (the id field) or from the course URL /courses/<id>. You can also pass an SIS ID as sis_course_id:<id>. Example: 1234.
- `page_url` (`string`, required): The page's url slug (from canvaslms_page_list, e.g. course-syllabus) or page_id:<id> to look up by numeric ID. Example: course-syllabus.

Example input: `{"course_id":"<course_id>","page_url":"<page_url>"}`

### `canvaslms_page_list`

List Pages · Read-only

List the wiki pages in a Canvas course, optionally filtered by a title search or published state.
Returns an array of pages with page_id, url, title, created_at, updated_at, published and front_page; the body only when include has body.
Use canvaslms_page_list to find a page's url slug. Use canvaslms_page_get to read one page's content.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `course_id` (`string`, required): ID of the course. Get it from canvaslms_course_list (the id field) or from the course URL /courses/<id>. You can also pass an SIS ID as sis_course_id:<id>. Example: 1234.
- `include` (`array`, optional): Extra data. Allowed: body. Example: ["body"].
- `order` (`string`, optional): Sort direction. Allowed: asc (default), desc. Example: desc. One of: `asc`, `desc`.
- `page` (`string`, optional): Page of results to return, starting at 1. Request the next page while a full page comes back. Example: 2.
- `per_page` (`integer`, optional): Number of results per page (Canvas default 10, max usually 100). Example: 50.
- `published` (`boolean`, optional): true returns only published pages, false only unpublished; omit for all. Example: true.
- `search_term` (`string`, optional): Partial page title to match. Example: syllabus.
- `sort` (`string`, optional): Sort field. Allowed: title, created_at, updated_at. Example: updated_at. One of: `title`, `created_at`, `updated_at`.

Example input: `{"course_id":"<course_id>"}`

### `canvaslms_student_submission_list`

List Student Submissions · Read-only

List submissions across several assignments and students in a Canvas course, filtered by student, assignment or workflow state.
Returns an array of submissions with assignment_id, user_id, workflow_state, submitted_at, score, grade, late and missing.
Use canvaslms_student_submission_list for a student's work across a course or everything still to grade. Use canvaslms_submission_list for one assignment.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `course_id` (`string`, required): ID of the course. Get it from canvaslms_course_list (the id field) or from the course URL /courses/<id>. You can also pass an SIS ID as sis_course_id:<id>. Example: 1234.
- `assignment_ids` (`array`, optional): Assignment IDs to include. Defaults to all assignments. Example: ["9012", "9013"].
- `include` (`array`, optional): Extra data. Allowed: submission_history, submission_comments, rubric_assessment, assignment, visibility, course, user, read_status. Example: ["submission_comments", "user"].
- `page` (`string`, optional): Page of results to return, starting at 1. Request the next page while a full page comes back. Example: 2.
- `per_page` (`integer`, optional): Number of results per page (Canvas default 10, max usually 100). Example: 50.
- `student_ids` (`array`, optional): Student user IDs to include, or ["all"] for every student. Defaults to the calling user. Example: ["all"] or ["5678", "5679"].
- `submitted_since` (`string`, optional): Only return submissions submitted after this ISO 8601 time. Example: 2026-11-01T00:00:00Z.
- `workflow_state` (`string`, optional): Only return submissions in this state. Allowed: submitted, unsubmitted, graded, pending_review. Example: submitted. One of: `submitted`, `unsubmitted`, `graded`, `pending_review`.

Example input: `{"course_id":"<course_id>"}`

### `canvaslms_submission_get`

Get Submission · Read-only

Get one student's submission for an assignment in a Canvas course.
Returns id, user_id, workflow_state, submitted_at, score, grade, attempt, body, url, attachments and any requested include fields such as submission_comments or rubric_assessment.
Use canvaslms_submission_get to read a student's work before grading it with canvaslms_submission_grade.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `assignment_id` (`string`, required): ID of the assignment, from canvaslms_assignment_list. Example: 9012.
- `course_id` (`string`, required): ID of the course. Get it from canvaslms_course_list (the id field) or from the course URL /courses/<id>. You can also pass an SIS ID as sis_course_id:<id>. Example: 1234.
- `user_id` (`string`, required): ID of the student, or self for the calling user. Example: 5678.
- `include` (`array`, optional): Extra data. Allowed: submission_history, submission_comments, rubric_assessment, full_rubric_assessment, visibility, course, user, read_status. Example: ["submission_comments", "rubric_assessment"].

Example input: `{"assignment_id":"<assignment_id>","course_id":"<course_id>","user_id":"<user_id>"}`

### `canvaslms_submission_list`

List Assignment Submissions · Read-only

List all students' submissions for one assignment in a Canvas course.
Returns an array of submissions with id, user_id, workflow_state, submitted_at, score, grade, late, missing, attempt, body or url, and any requested include fields.
Use canvaslms_submission_list to review or grade one assignment. Use canvaslms_student_submission_list across several assignments or students, and canvaslms_submission_get for one student.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `assignment_id` (`string`, required): ID of the assignment, from canvaslms_assignment_list. Example: 9012.
- `course_id` (`string`, required): ID of the course. Get it from canvaslms_course_list (the id field) or from the course URL /courses/<id>. You can also pass an SIS ID as sis_course_id:<id>. Example: 1234.
- `include` (`array`, optional): Extra data. Allowed: submission_history, submission_comments, rubric_assessment, assignment, visibility, course, user, read_status. Example: ["submission_comments", "user"].
- `page` (`string`, optional): Page of results to return, starting at 1. Request the next page while a full page comes back. Example: 2.
- `per_page` (`integer`, optional): Number of results per page (Canvas default 10, max usually 100). Example: 50.

Example input: `{"assignment_id":"<assignment_id>","course_id":"<course_id>"}`

### `canvaslms_user_get`

Get User · Read-only

Get a Canvas user's details, or the authenticated user's when user_id is self.
Returns id, name, sortable_name, short_name, login_id, email, avatar_url, locale and time_zone.
Use canvaslms_user_get to find out who the token belongs to or to look up one user by ID. Use canvaslms_course_user_list to find users in a course by name.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `user_id` (`string`, required): Canvas user ID, or self for the user who owns the access token. Example: self or 5678.
- `include` (`array`, optional): Extra fields to return. Allowed: uuid, last_login. Example: ["last_login"].

Example input: `{"user_id":"<user_id>"}`

### `canvaslms_assignment_create`

Create Assignment · Write

Create an assignment in a Canvas course.
Returns the new assignment with id, name, due_at, points_possible, published and html_url.
Use canvaslms_assignment_create for a new assignment. Use canvaslms_assignment_update to change an existing one.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `course_id` (`string`, required): ID of the course. Get it from canvaslms_course_list (the id field) or from the course URL /courses/<id>. You can also pass an SIS ID as sis_course_id:<id>. Example: 1234.
- `name` (`string`, required): Assignment title. Example: Essay 1: Argument Analysis.
- `assignment_group_id` (`integer`, optional): ID of the assignment group (gradebook category) to put the assignment in. Example: 321.
- `description` (`string`, optional): Assignment instructions as HTML. Example: Write 800 words on the assigned reading.

- `due_at` (`string`, optional): Due date and time in ISO 8601. Example: 2026-12-01T23:59:00Z.
- `grading_type` (`string`, optional): How the grade is shown. Allowed: pass_fail, percent, letter_grade, gpa_scale, points, not_graded. Example: points. One of: `pass_fail`, `percent`, `letter_grade`, `gpa_scale`, `points`, `not_graded`.
- `lock_at` (`string`, optional): When the assignment closes to submissions, ISO 8601. Example: 2026-12-03T23:59:00Z.
- `points_possible` (`number`, optional): Maximum points for the assignment. Example: 100.
- `published` (`boolean`, optional): Whether students can see the assignment. Example: true.
- `submission_types` (`array`, optional): How students submit. Allowed: online_quiz, none, on_paper, discussion_topic, external_tool, online_upload, online_text_entry, online_url, media_recording, student_annotation. Example: ["online_text_entry", "online_upload"].
- `unlock_at` (`string`, optional): When students can start the assignment, ISO 8601. Example: 2026-11-20T00:00:00Z.

Example input: `{"course_id":"<course_id>","name":"<name>"}`

### `canvaslms_assignment_update`

Update Assignment · Write

Update an existing assignment in a Canvas course; only the fields you pass change.
Returns the updated assignment with id, name, due_at, points_possible, published and html_url.
Use canvaslms_assignment_update to change dates, points, instructions or publish state. Use canvaslms_assignment_create for a new assignment.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `assignment_id` (`string`, required): ID of the assignment to update, from canvaslms_assignment_list. Example: 9012.
- `course_id` (`string`, required): ID of the course. Get it from canvaslms_course_list (the id field) or from the course URL /courses/<id>. You can also pass an SIS ID as sis_course_id:<id>. Example: 1234.
- `assignment_group_id` (`integer`, optional): ID of the assignment group (gradebook category) to put the assignment in. Example: 321.
- `description` (`string`, optional): Assignment instructions as HTML. Example: Write 800 words on the assigned reading.

- `due_at` (`string`, optional): Due date and time in ISO 8601. Example: 2026-12-01T23:59:00Z.
- `grading_type` (`string`, optional): How the grade is shown. Allowed: pass_fail, percent, letter_grade, gpa_scale, points, not_graded. Example: points. One of: `pass_fail`, `percent`, `letter_grade`, `gpa_scale`, `points`, `not_graded`.
- `lock_at` (`string`, optional): When the assignment closes to submissions, ISO 8601. Example: 2026-12-03T23:59:00Z.
- `name` (`string`, optional): Assignment title. Example: Essay 1: Argument Analysis.
- `points_possible` (`number`, optional): Maximum points for the assignment. Example: 100.
- `published` (`boolean`, optional): Whether students can see the assignment. Example: true.
- `submission_types` (`array`, optional): How students submit. Allowed: online_quiz, none, on_paper, discussion_topic, external_tool, online_upload, online_text_entry, online_url, media_recording, student_annotation. Example: ["online_text_entry", "online_upload"]. Only changes when the assignment has no submissions yet.
- `unlock_at` (`string`, optional): When students can start the assignment, ISO 8601. Example: 2026-11-20T00:00:00Z.

Example input: `{"assignment_id":"<assignment_id>","course_id":"<course_id>"}`

### `canvaslms_calendar_event_create`

Create Calendar Event · Write

Create a calendar event on a course, group or user calendar in Canvas.
Returns the new event with id, title, start_at, end_at, context_code and html_url.
Use canvaslms_calendar_event_create to schedule a class session, office hours or deadline reminder. Use canvaslms_calendar_event_list to read the calendar.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `context_code` (`string`, required): Calendar to add the event to, such as course_1234 or user_5678. Example: course_1234.
- `all_day` (`boolean`, optional): Make it an all-day event. Example: false.
- `description` (`string`, optional): Event description as HTML. Example: Drop in with questions about Essay 1.

- `end_at` (`string`, optional): End time, ISO 8601. Example: 2026-11-20T16:00:00Z.
- `location_address` (`string`, optional): Location address. Example: 100 Main St, Springfield.
- `location_name` (`string`, optional): Location name. Example: Room 204.
- `start_at` (`string`, optional): Start time, ISO 8601. Example: 2026-11-20T15:00:00Z.
- `title` (`string`, optional): Event title. Example: Office hours.

Example input: `{"context_code":"<context_code>"}`

### `canvaslms_conversation_create`

Send Message · Write

Send a new Canvas inbox message to one or more users, a course or a group.
Returns an array of the conversations created, each with id, subject, participants and the new message.
Use canvaslms_conversation_create to start a new thread. Use canvaslms_conversation_message_add to reply in an existing one.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `body` (`string`, required): Message text. Example: Reminder: Essay 1 is due Friday.
- `recipients` (`array`, required): Recipients: user IDs, or course_<id> / group_<id> codes (a course code messages everyone in it). Example: ["5678", "5679"] or ["course_1234"].
- `context_code` (`string`, optional): Course or group the message is sent in, such as course_1234. Example: course_1234.
- `force_new` (`boolean`, optional): Always start a new conversation instead of adding to an existing private one with the same recipient. Example: true.
- `group_conversation` (`boolean`, optional): true sends one shared conversation to all recipients; false (default) sends a separate private message to each. Example: false.
- `subject` (`string`, optional): Subject, up to 255 characters. Example: Essay 1 reminder.

Example input: `{"body":"<body>","recipients":["5678","5679"]}`

### `canvaslms_conversation_message_add`

Reply to Conversation · Write

Add a message to an existing Canvas inbox conversation.
Returns the conversation with the new message first in its messages array.
Use canvaslms_conversation_message_add to reply in a thread. Use canvaslms_conversation_create to start a new one.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `body` (`string`, required): Message text. Example: Thanks, I will review it tonight.
- `conversation_id` (`string`, required): ID of the conversation, from canvaslms_conversation_list. Example: 2468.
- `recipients` (`array`, optional): User IDs to send to. Defaults to all current participants. Example: ["5678"].

Example input: `{"body":"<body>","conversation_id":"<conversation_id>"}`

### `canvaslms_discussion_entry_create`

Reply to Discussion Topic · Write

Post a top-level reply to a discussion topic in a Canvas course.
Returns the new entry with id, user_id, message and created_at.
Use canvaslms_discussion_entry_create to reply to a discussion. Use canvaslms_discussion_topic_create to start a new topic.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `course_id` (`string`, required): ID of the course. Get it from canvaslms_course_list (the id field) or from the course URL /courses/<id>. You can also pass an SIS ID as sis_course_id:<id>. Example: 1234.
- `message` (`string`, required): Reply body as HTML or plain text. Example: I found the 1848 census records useful because...

- `topic_id` (`string`, required): ID of the discussion topic or announcement, from canvaslms_discussion_topic_list. Example: 3456.

Example input: `{"course_id":"<course_id>","message":"<message>","topic_id":"<topic_id>"}`

### `canvaslms_discussion_topic_create`

Create Discussion Topic or Announcement · Write

Create a discussion topic in a Canvas course, or an announcement when is_announcement is true.
Returns the new topic with id, title, message, published, posted_at and html_url.
Use canvaslms_discussion_topic_create to start a discussion or post an announcement. Use canvaslms_discussion_entry_create to reply to an existing topic.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `course_id` (`string`, required): ID of the course. Get it from canvaslms_course_list (the id field) or from the course URL /courses/<id>. You can also pass an SIS ID as sis_course_id:<id>. Example: 1234.
- `message` (`string`, required): Body as HTML. Example: Share one primary source you found and why it matters.

- `title` (`string`, required): Topic or announcement title. Example: Week 3 discussion: primary sources.
- `delayed_post_at` (`string`, optional): Schedule the topic to appear at this ISO 8601 time. Example: 2026-11-20T08:00:00Z.
- `discussion_type` (`string`, optional): Reply layout. Allowed: side_comment, threaded, not_threaded. Example: threaded. One of: `side_comment`, `threaded`, `not_threaded`.
- `is_announcement` (`boolean`, optional): Post as a course announcement instead of a discussion. Example: true.
- `lock_at` (`string`, optional): Close the topic to replies at this ISO 8601 time. Example: 2026-11-27T23:59:00Z.
- `pinned` (`boolean`, optional): Pin the topic to the top of the list. Example: false.
- `published` (`boolean`, optional): Whether students can see the topic. Example: true.
- `require_initial_post` (`boolean`, optional): Students must post before they can see other replies. Example: true.

Example input: `{"course_id":"<course_id>","message":"<message>","title":"<title>"}`

### `canvaslms_page_create`

Create Page · Write

Create a wiki page in a Canvas course.
Returns the new page with page_id, url, title, body, published and html_url.
Use canvaslms_page_create for a new page. Use canvaslms_page_update to change an existing one.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `course_id` (`string`, required): ID of the course. Get it from canvaslms_course_list (the id field) or from the course URL /courses/<id>. You can also pass an SIS ID as sis_course_id:<id>. Example: 1234.
- `title` (`string`, required): Page title. Changing it on update also changes the page URL. Example: Week 3 Overview.
- `body` (`string`, optional): Page content as HTML. Example: <h2>Readings</h2>Chapter 4

- `editing_roles` (`string`, optional): Who can edit the page, as a comma-separated list of teachers, students, members, public. Example: teachers.
- `front_page` (`boolean`, optional): Make this the course's front page. Example: false.
- `notify_of_update` (`boolean`, optional): Notify course participants that the page changed. Example: false.
- `published` (`boolean`, optional): Whether students can see the page. Example: true.

Example input: `{"course_id":"<course_id>","title":"<title>"}`

### `canvaslms_page_update`

Update Page · Write

Update a wiki page in a Canvas course; only the fields you pass change.
Returns the updated page with page_id, url, title, body and published.
Use canvaslms_page_update to edit content, rename or publish a page. Use canvaslms_page_create for a new page.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `course_id` (`string`, required): ID of the course. Get it from canvaslms_course_list (the id field) or from the course URL /courses/<id>. You can also pass an SIS ID as sis_course_id:<id>. Example: 1234.
- `page_url` (`string`, required): The page's url slug (from canvaslms_page_list, e.g. course-syllabus) or page_id:<id> to look up by numeric ID. Example: course-syllabus.
- `body` (`string`, optional): Page content as HTML. Example: <h2>Readings</h2>Chapter 4

- `editing_roles` (`string`, optional): Who can edit the page, as a comma-separated list of teachers, students, members, public. Example: teachers.
- `front_page` (`boolean`, optional): Make this the course's front page. Example: false.
- `notify_of_update` (`boolean`, optional): Notify course participants that the page changed. Example: false.
- `published` (`boolean`, optional): Whether students can see the page. Example: true.
- `title` (`string`, optional): Page title. Changing it on update also changes the page URL. Example: Week 3 Overview.

Example input: `{"course_id":"<course_id>","page_url":"<page_url>"}`

### `canvaslms_submission_grade`

Grade Submission · Write

Grade a student's submission, excuse it, or add a comment to it, in a Canvas course.
Returns the updated submission with score, grade, workflow_state and submission_comments.
Use canvaslms_submission_grade to post a grade or feedback. Use canvaslms_submission_get first to read the work.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `assignment_id` (`string`, required): ID of the assignment, from canvaslms_assignment_list. Example: 9012.
- `course_id` (`string`, required): ID of the course. Get it from canvaslms_course_list (the id field) or from the course URL /courses/<id>. You can also pass an SIS ID as sis_course_id:<id>. Example: 1234.
- `user_id` (`string`, required): ID of the student whose submission you are grading. Example: 5678.
- `excuse` (`boolean`, optional): Set true to excuse the student from the assignment instead of grading it. Example: true.
- `posted_grade` (`string`, optional): Grade to assign, matching the assignment's grading type: points (13.5), a percentage (40%), a letter grade (A-), or pass, complete, fail or incomplete. Example: 92.
- `text_comment` (`string`, optional): Text comment to add to the submission, visible to the student. Example: Strong thesis; cite more sources next time.

Example input: `{"assignment_id":"<assignment_id>","course_id":"<course_id>","user_id":"<user_id>"}`

## Related

Other Productivity connectors ([all 203](/agentkit/connectors/?category=productivity)):

- [Slack](/agentkit/connectors/slack/): Scalekit connector, OAuth, 96 tools
- [Notion](/agentkit/connectors/notion/): Scalekit connector, OAuth, 51 tools
- [Google Workspace (DWD)](/agentkit/connectors/googledwd/): Scalekit connector, Service account, 100 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
