MCP server
IntakeQ MCP by usefulapi
Search clients, appointments, intakes, notes and invoices in IntakeQ, and book or cancel…
- Runs
- Remotely
- Version
- 1.40.0
- Listing updated
- 4 days ago
About IntakeQ MCP by usefulapi
IntakeQ MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Search clients, appointments, intakes, notes and invoices in IntakeQ, and book or cancel visits.
Install
Run in a terminal
claude mcp add --transport http intakeq https://intakeq.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://intakeq.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"intakeq": {
"url": "https://intakeq.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": {
"intakeq": {
"type": "http",
"url": "https://intakeq.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"intakeq": {
"serverUrl": "https://intakeq.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"intakeq": {
"type": "http",
"url": "https://intakeq.usefulapi.io/mcp"
}
}
}Tools this server provides (19)
Read directly from the server.
- intakeq_list_clients
- Search the practice's clients (patients) by name, email or client number, by created/updated date range, by external id, or by a custom field. Without include_profile it returns Name, Email, Phone and ClientNumber; with include_profile=true it returns the full profile (address, insurance, tags, custom fields, linked clients). Max 100 per page. IntakeQ: GET /clients.
- intakeq_get_client_diagnoses
- List the diagnoses recorded for one client: code, description, start/end date and the treatment note they came from. IntakeQ: GET /client/{clientId}/diagnoses.
- intakeq_list_appointments
- Query appointments by client name/email, date range, status, practitioner or last-modified date. Max 100 per page. IntakeQ: GET /appointments.
- intakeq_get_appointment
- Fetch one appointment: client, practitioner, service, location, start/end, status, price, invoice, telehealth link and cancellation details. IntakeQ: GET /appointments/{id}.
- intakeq_get_booking_settings
- List the scheduler's locations, services (with duration and price) and practitioners — the ids you need to create an appointment. IntakeQ: GET /appointments/settings.
- intakeq_list_intakes
- Query submitted intake questionnaires (summaries: client, status, questionnaire, practitioner, dates). By default only completed forms; set all=true for every status (Sent, Partial, Completed, Offline). Max 100 per page. IntakeQ: GET /intakes/summary.
- intakeq_get_intake
- Fetch one intake questionnaire with every question and answer, its consent forms and linked appointment. IntakeQ: GET /intakes/{id}.
- intakeq_list_questionnaires
- List the intake questionnaire templates in the account (id, name, archived, anonymous) — the ids you need to send one. IntakeQ: GET /questionnaires.
- intakeq_list_practitioners
- List the practitioners in the account (id, name, email, external id). IntakeQ: GET /practitioners.
- intakeq_list_notes
- Query treatment note summaries by client, lock status, date range or last-updated date. Max 100 per page. IntakeQ: GET /notes/summary.
- intakeq_get_note
- Fetch one treatment note with every question and answer and its linked appointment. IntakeQ: GET /notes/{id}.
- intakeq_list_invoices
- Query invoices by client, issue date range, status, practitioner or last-updated range. Each invoice includes items, payments and amounts due/paid. Max 100 per page. IntakeQ: GET /invoices.
- intakeq_get_invoice
- Fetch one invoice: line items, taxes, discounts, payments, totals and amount due. IntakeQ: GET /invoices/{id}.
- intakeq_save_client
- Create a client, or update one. With ClientId the existing client is updated. WITHOUT ClientId IntakeQ still tries to match an existing client by first name + email (or first name + phone) and updates that one instead of creating a duplicate. For updates, fetch the full profile first (intakeq_list_clients with include_profile=true) and send it back with your changes, so no field is unintentionally
- intakeq_add_client_tag
- Add a tag to a client. The tag is created if it does not exist; adding one the client already has is a no-op. IntakeQ: POST /clientTags.
- intakeq_create_appointment
- Book an appointment in the PracticeQ scheduler. Get PractitionerId, ServiceId and LocationId from intakeq_get_booking_settings. All fields are required by IntakeQ. Status must be Confirmed or WaitingConfirmation; SendClientEmailNotification may be true only when Status is Confirmed. IntakeQ: POST /appointments.
- intakeq_update_appointment
- Change an appointment's time, service, location, status or reminder type. Id and UtcDateTime are required (send the current time to keep it); include only the other fields you are changing. The client and practitioner cannot be changed, and a Confirmed appointment cannot go back to WaitingConfirmation. IntakeQ: PUT /appointments.
- intakeq_cancel_appointment
- Cancel an appointment, with an optional reason. This changes the client's booking and cannot be undone through the API — book a new appointment to replace it. IntakeQ: POST /appointments/cancellation.
- intakeq_send_questionnaire
- Send an intake questionnaire to a client by email or SMS. This MESSAGES THE CLIENT. Identify the client by ClientId, or by ClientName plus ClientEmail and/or ClientPhone (omit ClientEmail to force SMS). PractitionerId is optional. Returns the new intake. IntakeQ: POST /intakes/send.
IntakeQ MCP by usefulapi FAQ
How do I add IntakeQ MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http intakeq https://intakeq.usefulapi.io/mcp