# Teachworks MCP by usefulapi

> Teachworks MCP by usefulapi is an MCP server. Read Teachworks students, families, tutors, lessons, invoices and payments; book lessons. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/teachworks/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/teachworks
- **MCP Registry name:** io.usefulapi/teachworks
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://teachworks.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "teachworks": {
      "serverUrl": "https://teachworks.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "teachworks": {
      "type": "http",
      "url": "https://teachworks.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `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.

## 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

---
Source: https://ai-powered.com/mcp/teachworks-mcp-by-usefulapi
