MCP server
Teachworks MCP by usefulapi
Read Teachworks students, families, tutors, lessons, invoices and payments; book lessons.
- Runs
- Remotely
- Version
- 1.31.0
- Listing updated
- 4 days ago
About Teachworks MCP by usefulapi
Teachworks MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Install
Run in a terminal
claude mcp add --transport http teachworks https://teachworks.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://teachworks.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"teachworks": {
"url": "https://teachworks.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"teachworks": {
"type": "http",
"url": "https://teachworks.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"teachworks": {
"serverUrl": "https://teachworks.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"teachworks": {
"type": "http",
"url": "https://teachworks.usefulapi.io/mcp"
}
}
}Tools this server provides (24)
Read directly from the server.
- teachworks_list_students
- List or search students (child students of families and independent students) with their school, grade, subjects, status, billing method and default teachers. GET /students.
- teachworks_get_student
- Retrieve one student profile: contact details, school/grade, billing, custom fields, default teachers/services. GET /students/{id}.
- teachworks_list_customers
- List or search customers — the billed profiles: families (with child students) and independent students. Returns contact details, status and last invoice date. GET /customers.
- teachworks_get_customer
- Retrieve one customer (family or independent student) with contact details and custom fields. GET /customers/{id}.
- teachworks_list_employees
- List or search employees — teachers/tutors and administrative staff — with subjects, status and wage settings. GET /employees.
- teachworks_get_employee
- Retrieve one employee (teacher or staff): contact details, subjects, wage type, bio, permissions. GET /employees/{id}.
- teachworks_get_employee_earnings
- Total earnings of one employee (lessons, other events, other compensation, total) for an optional lesson status and date range. GET /employees/{id}/earnings.
- teachworks_get_lesson_totals
- Lesson totals for one student, customer or employee: count (default), duration in minutes, or (employees only) earnings, broken down by status, for an optional status and date range. GET /{students|customers|employees}/{id}/lesson_totals.
- teachworks_list_lessons
- List lessons (the calendar) with teacher, service, location, start/end, duration, status and participants. Filter by teacher, student, location, service, status and date range. GET /lessons.
- teachworks_get_lesson
- Retrieve one lesson with its participants (students, statuses, charges, notes), teacher, wage and cost. GET /lessons/{id}.
- teachworks_list_other_events
- List non-lesson calendar events (meetings, open houses, staff work) with location, times and participants. GET /other_events.
- teachworks_list_availabilities
- List teachers' weekly availability slots (day of week + start/end time). Use before scheduling a lesson. GET /availabilities.
- teachworks_list_invoices
- List invoices with customer, number, dates, status (Saved, Approved, Paid, Void) and totals. Filter by customer, status, invoice date or due date range. GET /invoices.
- teachworks_get_invoice
- Retrieve one invoice with its line items (lessons, charges), taxes and totals. GET /invoices/{id}.
- teachworks_list_payments
- List customer payments (amount, method, date, refunds, invoice allocations). Filter by customer and date range. GET /payments.
- teachworks_get_payment
- Retrieve one payment with its refunds and the invoices it is allocated to. GET /payments/{id}.
- teachworks_list_locations
- List locations and sub-locations (rooms) where lessons take place. GET /locations.
- teachworks_list_services
- List services (lesson types such as 'Math Tutoring') with their default cost and wage. GET /services.
- teachworks_list_subjects
- List standard subjects (used on student and teacher profiles). GET /subjects.
- teachworks_create_family
- WRITE: create a family customer (the billed parent profile that child students belong to). Add children afterwards with teachworks_create_child_student. POST /customers/family.
- teachworks_create_child_student
- WRITE: create a child student under an existing family (the family is billed for their lessons). POST /students.
- teachworks_create_lesson
- WRITE: schedule a single lesson on the calendar for one or more students with a teacher, service and location. Check teachworks_list_availabilities and teachworks_list_lessons first to avoid conflicts. POST /lessons.
- teachworks_add_student_to_lesson
- WRITE: add a student to an existing lesson (the lesson must still be Scheduled). PUT /lessons/{id}/add_student.
- teachworks_create_payment
- WRITE: record a payment received from a customer (bookkeeping only — it does not charge a card). POST /payments.
Teachworks MCP by usefulapi FAQ
How do I add Teachworks MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http teachworks https://teachworks.usefulapi.io/mcp