maurodruwel/smartschool-mcp

本页由 AI 翻译，技术细节请以原文为准。查看原文

6 stars 7 forks 质量 81 趋势 34MIT

Smartschool MCP: A Model Context Protocol (MCP) server that enables seamless communication between AI agents and the Smartschool platform. 🧠

概览

Connect Claude (and other MCP clients) to your Smartschool account — ask about grades, assignments, messages, and your schedule in plain language. Or add it manually to claude_desktop_config.json: Config file locations: %APPDATA%\Claude\claude_desktop_config.json (Windows) · ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) · ~/.config/Claude/claude_desktop_config.json (Linux) The server supports transport for use as a remote integration on claude.ai. One server instance, your credentials in environment variables: Add to claude.ai → Settings → Integrations: - https://your-domain.example.com/mcp - Bearer (if set) One hosted server instance serves Smartschool user via OAuth 2.1. Users authenticate through a browser-based login form during the authorization flow. In claude.ai → Settings → Integrations → Add custom integration: - https://your-domain.example.com/mcp

README

以下为原文 README 节选，完整内容请查看原文。

Smartschool MCP Server

Connect Claude (and other MCP clients) to your Smartschool account — ask about grades, assignments, messages, and your schedule in plain language.

Tools

Tool	What it does
`get_courses`	List enrolled courses with teacher info
`get_results`	Grades with optional filtering, pagination, and statistics
`get_future_tasks`	Upcoming assignments organised by date
`get_messages`	Inbox/sent/trash with search, sender filter, and body retrieval
`get_schedule`	Day schedule by offset (0 = today, 1 = tomorrow, …)
`get_periods`	Academic terms for the current school year
`get_reports`	Available report cards
`get_planned_elements`	Planner items for the next N days
`get_student_support_links`	School support resources and links
`get_student_notes`	Student file notes (Leerlingvolgsysteem), without confidential notes; details on request (`text`, `fields`, `date`, `choice`, `attachments` as name + mime)
`get_student_absences`	Absences recorded in the Leerlingvolgsysteem (date, code, description, part of day)
`get_attachments`	List attachments for a specific message
`download_attachment`	Download a specific attachment by message and file ID
`get_homepage_blocks`	“In de kijker” blocks pinned to the homepage (e.g. monthly menu, calendar)
`download_homepage_image`	Download an image embedded in a homepage block

Quick start — Claude Desktop

uvx mcp install smartschool-mcp \
  -e SMARTSCHOOL_USERNAME="you" \
  -e SMARTSCHOOL_PASSWORD="secret" \
  -e SMARTSCHOOL_MAIN_URL="school.smartschool.be" \
  -e SMARTSCHOOL_MFA="YYYY-MM-DD"

Or add it manually to claude_desktop_config.json:

{
  "mcpServers": {
    "smartschool": {
      "command": "uvx",
      "args": ["smartschool-mcp"],
      "env": {
        "SMARTSCHOOL_USERNAME": "you",
        "SMARTSCHOOL_PASSWORD": "secret",
        "SMARTSCHOOL_MAIN_URL": "school.smartschool.be",
        "SMARTSCHOOL_MFA": "YYYY-MM-DD"
      }
    }
  }
}

在 GitHub 查看完整 README

安装

uvx smartschool-mcp

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "smartschool": {
      "command": "uvx",
      "args": ["smartschool-mcp"],
      "env": {
        "SMARTSCHOOL_USERNAME": "you",
        "SMARTSCHOOL_PASSWORD": "secret",
        "SMARTSCHOOL_MAIN_URL": "school.smartschool.be",
        "SMARTSCHOOL_MFA": "YYYY-MM-DD"
      }
    }
  }
}