MCP server

Teachworks MCP by usefulapi

io.usefulapi/teachworks

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Read Teachworks students, families, tutors, lessons, invoices and payments; book lessons.

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

24

Token cost

About 7,047 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http teachworks https://teachworks.usefulapi.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.teachworks]
url = "https://teachworks.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"teachworks":{"httpUrl":"https://teachworks.usefulapi.io/mcp"}}}

Cursor

{"mcpServers":{"teachworks":{"url":"https://teachworks.usefulapi.io/mcp"}}}

VS Code

{"servers":{"teachworks":{"type":"http","url":"https://teachworks.usefulapi.io/mcp"}}}

Antigravity

agy mcp add teachworks https://teachworks.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"teachworks","server_url":"https://teachworks.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"teachworks","server_url":"https://teachworks.usefulapi.io/mcp"}

Tools

• teachworks_add_student_to_lesson ~181 tokens
  WRITE: add a student to an existing lesson (the lesson must still be Scheduled). PUT /lessons/{id}/add_student.
• teachworks_create_child_student ~488 tokens
  WRITE: create a child student under an existing family (the family is billed for their lessons). POST /students.
• teachworks_create_family ~288 tokens
  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_lesson ~570 tokens
  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_create_payment Moves money · ~244 tokens
  WRITE: record a payment received from a customer (bookkeeping only — it does not charge a card). POST /payments.
• teachworks_get_customer ~131 tokens
  Retrieve one customer (family or independent student) with contact details and custom fields. GET /customers/{id}.
• teachworks_get_employee ~132 tokens
  Retrieve one employee (teacher or staff): contact details, subjects, wage type, bio, permissions. GET /employees/{id}.
• teachworks_get_employee_earnings ~251 tokens
  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_invoice ~125 tokens
  Retrieve one invoice with its line items (lessons, charges), taxes and totals. GET /invoices/{id}.
• teachworks_get_lesson ~131 tokens
  Retrieve one lesson with its participants (students, statuses, charges, notes), teacher, wage and cost. GET /lessons/{id}.
• teachworks_get_lesson_totals ~350 tokens
  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_get_payment ~124 tokens
  Retrieve one payment with its refunds and the invoices it is allocated to. GET /payments/{id}.
• teachworks_get_student ~134 tokens
  Retrieve one student profile: contact details, school/grade, billing, custom fields, default teachers/services. GET /students/{id}.
• teachworks_list_availabilities ~270 tokens
  List teachers' weekly availability slots (day of week + start/end time). Use before scheduling a lesson. GET /availabilities.
• teachworks_list_customers ~355 tokens
  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_list_employees ~305 tokens
  List or search employees — teachers/tutors and administrative staff — with subjects, status and wage settings. GET /employees.
• teachworks_list_invoices ~450 tokens
  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_list_lessons ~751 tokens
  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_list_locations ~192 tokens
  List locations and sub-locations (rooms) where lessons take place. GET /locations.
• teachworks_list_other_events ~443 tokens
  List non-lesson calendar events (meetings, open houses, staff work) with location, times and participants. GET /other_events.
• teachworks_list_payments ~299 tokens
  List customer payments (amount, method, date, refunds, invoice allocations). Filter by customer and date range. GET /payments.
• teachworks_list_services ~197 tokens
  List services (lesson types such as 'Math Tutoring') with their default cost and wage. GET /services.
• teachworks_list_students ~442 tokens
  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_list_subjects ~194 tokens
  List standard subjects (used on student and teacher profiles). GET /subjects.

Browse

• Website monitoring
• Calendars
• Booking and scheduling
• Payments

Related MCP servers

• TutorPing
  Find and book independent tutors, or find students asking for a tutor in your subject.
• The Dutch Directory
  Dutch-learning market map: schools, Verified Pro tutors, exams, paths and courses near any capital.
• Tutoring
  Find and book verified 1-on-1 online tutors: search by subject, price and rating, then book.
• Scholarize: Study Plans, Citations, Quizzes & Flashcards
  Free study plans, thesis statements and citations. Quizzes, flashcards and AI tutor need an account.
• QuailOS
  Farm management for poultry, quail & egg farms: flocks, eggs, hatches, orders, tasks, calendar.
• SuperȘcoala
  Romanian K-12 lessons, subjects, courses, teachers and packages from scoala.ro
• Kicksmash
  Padel matches for people and agents: create, share one link, join, americano schedules, levels.
• Homeschool Tools
  Search, compare and read reviews of 350+ homeschool curricula. Read-only, no account needed.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/teachworks.svg)](https://aptlynx.net/servers/io.usefulapi/teachworks)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents