Read-onlyAppointmentsMCP tool
appointments_list
Search for appointments by date range, status, or text.
Search for appointments by date range, status, or text. Use to answer calendar questions or to find an appointment's ID before updating or cancelling it (for today's schedule, appointments_today is faster). Returns IDs only by default for efficiency; use the fields parameter to include additional data. Response includes relatedIds.contactIds for chainable operations.
Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | No | Search term — matches against title and location (case-insensitive partial match) |
start_date | string | No | Start date to filter from (YYYY-MM-DD) |
end_date | string | No | End date to filter to (YYYY-MM-DD) |
appointment_type | enum | No | Filter by appointment type · One of: buyer_consultation, lender_prequalification, listing_appointment, showing, property_tour, client_meeting, inspection, appraisal, signing, final_walkthrough, call, other, open_house, escrow_deadline, owner_blackout, escrow_service |
status | enum | No | Filter by appointment status · One of: scheduled, completed, cancelled, no_show |
fields | array of enum | No | Field groups to include. Empty/omitted = IDs only. Options: basic (id, title, type, status), schedule (times, location), contacts (contact name), full (all fields). · Values: basic, schedule, contacts, full |
limit | string | No | Max results. Use a number (e.g. "25") or "all". Default: 10. "all" and any value above 200 are capped at 200 server-side. |
Example prompts#
- "What showings do I have on the calendar next week?"
- "Find all my scheduled inspections between June 15 and June 30."
Safety#
Read-only. This tool never changes your data — it only looks things up. Safe to run anytime.
Previous name#
This tool was previously published as list_appointments. Call it by its current name — legacy names are kept here for reference and old links redirect, but they are not callable.