Allows exporting gradebook data to Canvas LMS format.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
A Model Context Protocol (MCP) server that enables AI assistants like Claude Desktop to interact with the Classavo education platform via natural language.
Course Management - Create courses, manage rosters, invite students
Assignments - Create, update, clone assignments and quizzes
Grading - View submissions, grade work, provide feedback
Attendance - Start sessions, generate codes, track attendance
Live Polling - Create and run polls during class
Discussions - Create threads, pin comments, manage discussions
Analytics - View insights, export gradebook to LMS formats
View Grades - See YOUR grades (privacy protected)
Submit Work - Submit assignments
Attendance - Check in with attendance codes
Polling - Vote in active polls
Discussions - Participate in discussions
Content - View course chapters and materials
Related MCP server: Classroom MCP
Important: This server implements strict privacy controls:
Students can ONLY view their own grades, submissions, and attendance
Student tools do not accept student_id parameters
API endpoints return only the authenticated user's data
Professor-only tools verify user role before execution
Python 3.10+
A Classavo account (Professor or Student)
Clone the repository:
git clone https://github.com/kiranprakashkm/classavo-mcp.git
cd classavo-mcpCreate a virtual environment:
python3 -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activateInstall dependencies:
pip install -r requirements.txtCreate a .env file or set these environment variables:
# Classavo API URL (production or local)
CLASSAVO_API_URL=https://api.classavo.com
# Option 1: Pre-configured API token
CLASSAVO_API_TOKEN=your_token_here
# Option 2: Username/password for login flow
CLASSAVO_USERNAME=your_email@example.com
CLASSAVO_PASSWORD=your_password
# Optional settings
CLASSAVO_RATE_LIMIT=10 # Requests per second
DEBUG=falseAdd to ~/.config/claude/claude_desktop_config.json (macOS/Linux) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"classavo": {
"command": "python",
"args": ["/path/to/classavo-mcp/main.py"],
"env": {
"CLASSAVO_API_URL": "https://api.classavo.com",
"CLASSAVO_USERNAME": "your_email@example.com",
"CLASSAVO_PASSWORD": "your_password"
}
}
}
}Alternatively, use an API token:
{
"mcpServers": {
"classavo": {
"command": "python",
"args": ["/path/to/classavo-mcp/main.py"],
"env": {
"CLASSAVO_API_URL": "https://api.classavo.com",
"CLASSAVO_API_TOKEN": "your_api_token_here"
}
}
}
}python main.pyAfter configuring Claude Desktop, restart it. The Classavo tools will be available automatically.
Tool | Description |
| Authenticate with username/password |
| End session |
| View current user info |
| View notifications |
Tool | Description | Access |
| List your courses | All |
| Get course details | All |
| Create a new course | Professor |
| View enrolled students | Professor |
| Invite students by email | Professor |
| Join with invite code | Student |
| View course insights | Professor |
Tool | Description | Access |
| List assignments | All |
| Get assignment details | All |
| Create assignment | Professor |
| Update assignment | Professor |
| Delete assignment | Professor |
| Add question to assignment | Professor |
| Clone to another course | Professor |
Tool | Description | Access |
| View all submissions | Professor |
| View submission details | Professor |
| Grade a submission | Professor |
| Full gradebook | Professor |
| Export to LMS format | Professor |
| Your grades only | Student |
| Your submissions only | Student |
| Submit your work | Student |
Tool | Description | Access |
| Start attendance | Professor |
| End session | Professor |
| View active sessions | Professor |
| Attendance report | Professor |
| Manual marking | Professor |
| Check in with code | Student |
| Your attendance | Student |
Tool | Description | Access |
| List polls | Professor |
| Create a poll | Professor |
| Launch poll | Professor |
| End poll | Professor |
| View results | Professor |
| Cast your vote | Student |
| View active polls | Student |
Tool | Description | Access |
| List discussions | All |
| View discussion | All |
| Create thread | Professor |
| Add comment | All |
| Pin comment | Professor |
| Delete thread | Professor |
Tool | Description | Access |
| Search across courses | All |
"List all my courses"
"Show the roster for Chemistry 101"
"Create a homework assignment called 'Chapter 5 Review' for course abc123"
"Start attendance for my Biology class"
"How did students do on the midterm exam?"
"Export grades to Canvas format""What are my grades in Chemistry?"
"Show my upcoming deadlines"
"Check me in with attendance code 1234"
"Submit my homework for assignment xyz"
"Vote option B in the current poll"pytest
pytest --cov=. --cov-report=term-missingclassavo-mcp/
├── main.py # FastMCP server entry point
├── config.py # Environment configuration
├── client.py # Async HTTP client for Classavo API
├── auth.py # Authentication management
├── tools/
│ ├── __init__.py # Tool registration
│ ├── auth_tools.py # Login, profile, notifications
│ ├── course_tools.py # Course CRUD, roster
│ ├── assignment_tools.py # Assignment management
│ ├── grading_tools.py # Submissions, grading
│ ├── attendance_tools.py # Attendance tracking
│ ├── polling_tools.py # Live polls
│ ├── discussion_tools.py # Discussion boards
│ └── student_tools.py # Student-specific (privacy protected)
├── requirements.txt
├── README.md
└── PLAN.mdMIT License - See LICENSE file for details.
For issues or questions:
Open an issue on GitHub
Contact the Classavo support team
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Connect AI assistants to Edusign attendance, courses, learners, documents, and API docs via OAuth.
Enables AI assistants to retrieve event data and execute event management operations in Nunify.
Access approved FITsociety clients, schedules, bookings and coaching data with AI assistants.
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
