Skip to content
MCP tools
View as Markdown
Creates dataAppointmentsMCP tool

appointments_create

Create a new appointment, showing, meeting, or follow-up.

Create a new appointment, showing, meeting, or follow-up. Use whenever the user wants something on their calendar. Call immediately with whatever data the user provides. Do NOT ask for missing fields — the system shows an editable draft card where the user can fill in remaining details. Returns the created appointment record.

Parameters#

ParameterTypeRequiredDescription
titlestringYesTitle or subject of the appointment
appointment_typeenumNoType of appointment · 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
start_timestringYesStart date and time (ISO 8601 format, e.g., 2025-01-15T14:00:00)
end_timestringNoEnd date and time (ISO 8601 format)
locationstringNoLocation or address of the appointment
notesstringNoNotes or description
contact_idstringNoUUID of the contact this appointment is with
listing_idstringNoUUID of the listing this appointment is for (if applicable)

Example prompts#

  • "Schedule a buyer consultation with the Garcias tomorrow at 2pm at my office."
  • "Book a listing appointment at 412 Birchwood Ln on Friday at 10am."

Safety#

Creates data. Creates a new record in your CRM and may trigger notifications or webhooks. Running it twice creates a duplicate, so Claude runs it once per request.

Previous name#

This tool was previously published as create_appointment. Call it by its current name — legacy names are kept here for reference and old links redirect, but they are not callable.