MCP App Store
by KeenEthics
School Timetable Builder icon

School Timetable Builder MCP Server for Claude and ChatGPT

By Theis Wilbek

Overview

School Timetable Builder creates a complete weekly timetable for a primary or lower-secondary school: one timetable per class and one per teacher, including rooms. Nothing to install or learn: drop in the files you already have (spreadsheets, documents, emails) or describe your school in the chat, in your own language. Claude reads everything, asks only what it can't work out, and checks the data with the service in seconds (e.g. enough qualified teachers and time in the week). The engine then calculates the whole timetable, usually in 3-8 minutes. Every rule is a firm rule: the timetable meets all of them, or you get a plain explanation of what clashes, and you decide what to change. Rules the engine handles: - Teacher availability: block any day or lesson, e.g. "not after lesson 4 on Fridays" or "teaches at another school on Mondays" - Blocked lessons for a class or a whole grade - Teacher workload: lessons per week, part-time - No gaps: planning time at school is placed in each teacher's timetable, and by default teachers' days have no empty gaps - Fixed teachers for a class and subject - Double lessons, and a daily limit per subject (e.g. English once a day) - Shared special rooms with limited capacity (sports hall, music room, workshops) - Classes taught at the same time, and groups inside a class with their own teacher (e.g. CRE and IRE) - 5 or 6 days, 1-12 lessons a day, any lesson length, grades 0-10 You get the timetable as files in the chat (e.g. a spreadsheet with one sheet per class and one per teacher), plus a "School data" file to change a detail and run it again later. Not included: student-choice course timetables (high-school style), whole-day events, and soft "if possible" preferences that are weighed against each other. Privacy: Claude replaces teacher names with codes (T01, T02, ...) before anything is sent. The service never receives the names of teachers, pupils or the school, and deletes all data within 24 hours. No account needed.

How to connect

  1. Claude: Open the School Timetable Builder listing in the Claude connectors directory and choose Connect. Claude listing School Timetable Builder exposes 5 tools here.
  2. ChatGPT: Open the School Timetable Builder listing in the ChatGPT app directory and choose Connect. ChatGPT listing School Timetable Builder exposes 5 tools here.

Tools

create_schedule

ChatGPT
Starts calculating the full timetable from the 8 input files (validate them first). Returns a job_id at once; the calculation takes about 5-8 minutes. Then keep calling get_schedule_result with the job_id in the same reply until it is done.

get_interview_guide

ChatGPT
Returns the interview guide: which questions to ask the user, default values, engine limits and the exact format of the 8 input files. Call this first.

get_schedule_result

ChatGPT
Gets the status or result of a job from create_schedule (or a slow validate_input). While running: progress. When done: a compact timetable as text plus a link (valid 1 hour) to the full JSON result. view='classes' (default) = one table per class, 'teachers' = one per teacher incl. preparation time, 'summary' = key figures and lists of classes/teachers only. Use 'names' to get only some classes/teachers (recommended for big schools). If impossible: the reasons.

send_feedback

ChatGPT
Passes the user's feedback about the timetable service on to its developer (what worked, what did not, wishes). Only call it when the user has said they want to give feedback, and send what the user said in their own words (you may shorten it; any language is fine). Never include teacher names, other personal data or the school's data files. Tell the user briefly that it was sent. Nobody replies through this channel - if the user wants an answer, give them the support email timetablingengine.support@gmail.com.

validate_input

ChatGPT
Checks the 8 input files in a few seconds without creating a timetable: file structure, engine limits and a capacity analysis (enough teachers/time?). Returns VALID (with warnings) or INVALID (with reasons). Always run this before create_schedule.

create_schedule

Claude
Starts calculating the full timetable from the 8 input files (validate them first). Returns a job_id at once; the calculation takes about 5-8 minutes. Then keep calling get_schedule_result with the job_id in the same reply until it is done.

get_interview_guide

Claude
Returns the interview guide: which questions to ask the user, default values, engine limits and the exact format of the 8 input files. Call this first.

get_schedule_result

Claude
Gets the status or result of a job from create_schedule (or a slow validate_input). While running: progress. When done: a compact timetable as text plus a link (valid 1 hour) to the full JSON result. view='classes' (default) = one table per class, 'teachers' = one per teacher incl. preparation time, 'summary' = key figures and lists of classes/teachers only. Use 'names' to get only some classes/teachers (recommended for big schools). If impossible: the reasons.

send_feedback

Claude
Passes the user's feedback about the timetable service on to its developer (what worked, what did not, wishes). Only call it when the user has said they want to give feedback, and send what the user said in their own words (you may shorten it; any language is fine). Never include teacher names, other personal data or the school's data files. Tell the user briefly that it was sent. Nobody replies through this channel - if the user wants an answer, give them the support email timetablingengine.support@gmail.com.

validate_input

Claude
Checks the 8 input files in a few seconds without creating a timetable: file structure, engine limits and a capacity analysis (enough teachers/time?). Returns VALID (with warnings) or INVALID (with reasons). Always run this before create_schedule.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/school-timetable-builder"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/school-timetable-builder)