Canvas API MCP

canvas-api-mcp

課題の締め切りをもう逃しません。

AI に締め切りを尋ねると、Canvas から直接回答を読み取ります。
実際の締め切り、実際の提出状況を確認でき、情報をコピーして移す必要はありません。

Canvas LMS 用の MCP サーバーです。日々の学生生活で使える厳選された 16 個のツールに加え、お使いの Canvas インスタンスが公開しているすべてのエンドポイントにアクセスできるゲートウェイを備えています。

📖 ドキュメント：mcp.johannsenlum.com/canvas-lms · インストールガイド · ツールリファレンス · スキル · コンプライアンス

個人利用向けソフトウェアです。 Canvas の API ポリシーでは、複数の人が利用するアプリケーションに OAuth が求められます。また、Canvas OAuth はローカルにインストールするソフトウェアでは安全に実装できません（PKCE がなく、client_secret をパッケージに含めて配布できないためです）。 ご自身のアカウントで、ご自身のトークンを使ってください。コンプライアンスをご覧ください。

どんなことを尋ねられるか

実際のプロンプトと、それに回答するツールです。

あなた： 今週の締め切りは何ですか？ Claude： （whats_due を呼び出し）：締め切りが 3 件あります。Problem Set 4（木曜、CS3230）、ディスカッションへの返信（金曜、IS4302）、Milestone 2 のレポート（日曜、EE2211）です。

あなた： データベースの授業の成績はどうですか？ また、週 6 のシラバスには何が載っていますか？ Claude： （my_grades、続いて get_syllabus、さらに週 6 のモジュールについて course_content を呼び出し）：総合成績は 87% です。週 6 では正規化を扱い、金曜締め切りのリーディング課題とラボファイルがあります。

あなた： 第 8 回講義の PDF ノートを要約して、フィードバックを確認できるようにエッセイの提出物を開いてください。 Claude： （PDF に対して list_files と read_file を呼び出し、続いてエッセイに対して my_submission を呼び出し）：...

あなた： 「Project teams」のディスカッションに返信して、グループミーティングは午後 3 時以降なら参加できると伝えてください。 Claude： （post_discussion_reply ✏️ を呼び出し）：スレッドに投稿しました。

あなた： Canvas で、学期全体にわたるクイズの問題別統計を確認できますか？ Claude： （適切なエンドポイントを見つけるために search_canvas_api を呼び出し、続いて canvas_request で呼び出し）：...

最後の例がゲートウェイツールの要点です。お使いの Canvas インスタンスにエンドポイントが存在すれば、厳選されたツールは 16 個だけでも、search_canvas_api で見つけて canvas_request で呼び出せます。

インストール

前提条件

• Python 3.11+

• Canvas の個人アクセストークン。所属機関で学生によるトークン作成が許可されている必要があります。Canvas → Account → Settings → Approved Integrations に 「+ New access token」 ボタンがあるか確認してください。スクリーンショット付きの詳しい手順はこちらをご覧ください： mcp.johannsenlum.com/canvas-lms/install。

  トークンには有効期限があることにご注意ください。 Instructure による 2025 年 10 月のセキュリティ更新以降、学生ロールのみを持つアカウントでは、有効期限を 120 日以内に設定する必要があります。また、機関によってはさらに短い期間に制限されています（NUS では 90 日です）。有効期限を書き留めておきましょう。期限切れのトークンでは、すべてのツールが一斉に 401 を返すため、認証情報の期限切れではなく、インストールが壊れたように見えてしまいます。

サーバーの実行

canvas-api-mcp は PyPI で公開されています。次のコマンドで実行します：

uvx canvas-api-mcp

ソースからインストール（コントリビューター／未リリースの main）。 上記の通常のインストール手順には含まれません。公開済みの PyPI リリースではなく、最新の未リリースコードを使いたい場合にのみ必要です：

uvx --from git+https://github.com/JohannsenLum/canvas-api-mcp canvas-api-mcp

または、ローカルクローンから実行します：

git clone https://github.com/JohannsenLum/canvas-api-mcp
cd canvas-api-mcp
uv sync

クイックインストール（ワンクリック）

ワンクリックのディープリンクが利用できるのは Cursor、VS Code、LM Studio のみです。その他のクライアントには、ドキュメント化されたインストールリンク形式がありません。以下の設定があらかじめ入力されますが、その後 CANVAS_BASE_URL と CANVAS_TOKEN を入力する必要があります。

すべてのクライアント（手動設定）

トークンはご自身のマシン上の設定ファイルに保存されます。Canvas インスタンスに直接送信される場合を除き、外部に送信されることはありません。

{
  "mcpServers": {
    "canvas": {
      "command": "uvx",
      "args": ["canvas-api-mcp"],
      "env": {
        "CANVAS_BASE_URL": "https://canvas.yourschool.edu",
        "CANVAS_TOKEN": "your-token-here"
      }
    }
  }
}

{
  "mcpServers": {
    "canvas": {
      "command": "uvx",
      "args": ["canvas-api-mcp"],
      "env": {
        "CANVAS_BASE_URL": "https://canvas.yourschool.edu",
        "CANVAS_TOKEN": "your-token-here"
      }
    }
  }
}

{
  "mcpServers": {
    "canvas": {
      "command": "uvx",
      "args": ["canvas-api-mcp"],
      "env": {
        "CANVAS_BASE_URL": "https://canvas.yourschool.edu",
        "CANVAS_TOKEN": "your-token-here"
      }
    }
  }
}

{
  "servers": {
    "canvas": {
      "type": "stdio",
      "command": "uvx",
      "args": ["canvas-api-mcp"],
      "env": {
        "CANVAS_BASE_URL": "https://canvas.yourschool.edu",
        "CANVAS_TOKEN": "your-token-here"
      }
    }
  }
}

{
  "mcpServers": {
    "canvas": {
      "command": "uvx",
      "args": ["canvas-api-mcp"],
      "env": {
        "CANVAS_BASE_URL": "https://canvas.yourschool.edu",
        "CANVAS_TOKEN": "your-token-here"
      }
    }
  }
}

{
  "context_servers": {
    "canvas": {
      "source": "custom",
      "command": "uvx",
      "args": ["canvas-api-mcp"],
      "env": {
        "CANVAS_BASE_URL": "https://canvas.yourschool.edu",
        "CANVAS_TOKEN": "your-token-here"
      }
    }
  }
}

{
  "mcpServers": {
    "canvas": {
      "command": "uvx",
      "args": ["canvas-api-mcp"],
      "env": {
        "CANVAS_BASE_URL": "https://canvas.yourschool.edu",
        "CANVAS_TOKEN": "your-token-here"
      }
    }
  }
}

ツール

✏️ は Canvas への書き込みを行います。書き込みツールは合計 3 つです：submit_assignment、post_discussion_reply、および GET 以外のメソッドで呼び出した場合の canvas_request（canvas_request の GET 呼び出しは読み取り専用です）。

search_canvas_api と canvas_request を使うと、インスタンスが公開する約 1,116 個すべてのエンドポイントにアクセスできます。実行できる操作は、トークンの権限に基づいて Canvas が決定します。教師用トークンを使えば、このサーバーに変更を加えなくても教育者向けエンドポイントが利用できます。

プロンプト

week_ahead、study_pack、grade_check。

リソース

canvas://me、canvas://courses、canvas://api/catalog。

スキル

クライアントがスキル の規約に対応している場合：

npx skills add JohannsenLum/canvas-api-mcp

その他の教育機関

CANVAS_BASE_URL を設定すれば、どの Canvas インスタンスでも動作します。約1,116件の エンドポイントのカタログは、パッケージ内の canvas_api_mcp/data/catalog.json に含まれています。デプロイ環境の正確な機能 セットに合わせるには、再生成してください：

python scripts/build_catalog.py https://canvas.yourschool.edu -o data/catalog.json

コンプライアンス

• 学問の誠実性。 submit_assignment は、AI 生成の課題を含め、あらゆる内容を提出できます。自分のものではない課題を提出することは、実質的にすべての教育機関の学問の誠実性に関する規則に違反し、Canvas の API ポリシーでも、そのような規則に違反する利用を明示的に禁止しています。責任は利用者にあります。
• レート制限。 クライアントは、Canvas が公開しているクォータに従ってリクエストを調整します。これを削除しないでください。API に過度な負荷をかけることは禁止されています。
• コース教材。 read_file は、自分の学習用に教材を取得します。再配布しないでください。
• トークンはパスワードと同等です。 トークンを使うと、自分の成績を読み取ったり、自分として課題を提出したりできます。有効期限を設定してください。決してコミットしないでください。
• 個人利用の範囲。 フェーズ1では、自分のトークンを使う単一の学生を対象としています。教育者向けに厳選したツールはありません。Canvas の OAuth フローには PKCE がないため、このローカルインストール型サーバーでは、Canvas の API ポリシーがより広い用途に求めるマルチユーザー OAuth を実装できません。これをマルチテナントサービスとして再パッケージしないでください。

開発

uv sync
uv run pytest -v

# Live tests against your real account (read-only)
CANVAS_LIVE_TESTS=1 uv run pytest tests/test_live.py -v

環境変数：CANVAS_BASE_URL、CANVAS_TOKEN、任意の CANVAS_MAX_PAGES（デフォルトは10）とCANVAS_TIMEOUT（秒、デフォルトは30）。 env.template を参照してください。

コントリビューション

問題の報告やプルリクエストを歓迎します。セットアップ、変更前に把握しておくべきアーキテクチャ上のルール、新しい厳選ツールを追加する際の基準については、CONTRIBUTING.md を参照してください。

セキュリティ上の問題を見つけましたか？公開の問題として報告しないでください。 非公開での報告方法についてはSECURITY.md を参照してください。このプロジェクトはパスワードと同等の Canvas トークンを扱うため、特に重要です。

変更はCHANGELOG.md に記録されます。

ライセンス

MIT © 2026 Johannsen Lum.

自由に利用、変更、再配布し、商用のものを構築できます。唯一の条件は、著作権表示とライセンス文を保持することです。いかなる種類の保証もありません。

コントリビューションにも同じライセンスが適用されます。