Lawmatics MCP Tool - Create Event

Q: What does the Create Event tool do?

This page documents the Create Event tool (lawmatics_create-event). Create an event (appointment) in Lawmatics. Provide the name, start/end times, the hosting firm user IDs, the event type, and the ID of exactly one entity (matter or contact, companies cannot have appointments) the appointment is with. Optionally set a description, location, reminder, time zone, and invite behavior. It is one of the Lawmatics Events tools, invoked through your firm's Weave MCP connection and available to members whose access level permits it.

Create Event (lawmatics_create-event)

Create an event (appointment) in Lawmatics. Provide the name, start/end times, the hosting firm user IDs, the event type, and the ID of exactly one entity (matter or contact — companies cannot have appointments) the appointment is with. Optionally set a description, location, reminder, time zone, and invite behavior.

Tool Input

namestring— Name/title of the event (appointment)

descriptionstring— Description of the event

startDatestring(date-time)— When the event starts, as an ISO 8601 timestamp(pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z||([+-](?:[01]\d|2[0-3]):[0-5]\d)))$)

endDatestring(date-time)— When the event ends, as an ISO 8601 timestamp(pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z||([+-](?:[01]\d|2[0-3]):[0-5]\d)))$)

userIdsarray— IDs of the firm users hosting the appointment; numeric strings(min items: 1)

[]string(pattern: ^\d+$)

matterIdstring— ID of the matter the appointment is with

contactIdstring— ID of the contact the appointment is with

eventTypeIdstring— ID of the event type for this event; a numeric string(pattern: ^\d+$)

locationIdstring— ID of the firm location the event is held at; a numeric string(pattern: ^\d+$)

allDayboolean— Whether the event is an all-day event (default false)

reminderDelayLengthinteger— How many reminderType units before the event to send a reminder; provide together with reminderType(> 0)

reminderTypestring— Unit for the reminder delay; provide together with reminderDelayLength(enum: "minutes", "hours", "days", "weeks", "months")

sendInvitesboolean— Whether to send calendar invites to attendees (default true)

noShowboolean— Whether the appointment is marked as a no-show (default false)

timeZonestring— IANA tz identifier to schedule the event in (e.g. "America/Los_Angeles")

Tool Output

idstring— Lawmatics event (appointment) ID

namestring— Name/title of the event

descriptionstringnull— Description of the event; null if unset

timeZonestringnull— IANA tz identifier the event is scheduled in (e.g. "America/Los_Angeles"); null if unset

startDatestringnull— When the event starts, as an ISO 8601 timestamp; null when the date has been cleared

endDatestringnull— When the event ends, as an ISO 8601 timestamp; null when the date has been cleared

allDaybooleannull— True when the event is an all-day event; null when never explicitly set (treat as not all-day)

reminderTypestringnull— Unit for the reminder delay ("minutes", "hours", "days", "weeks", "months"); null when no reminder is configured

reminderDelayLengthnumbernull— How many reminderType units before the event the reminder is sent; null when no reminder is configured

reminderSentboolean— True when the reminder has already been sent

locationobjectnull— Firm location the event is held at; null when no location is set

idnumber— Lawmatics event location ID

namestring— Name of the event location

addressIdnumbernull— ID of the address record for the location; null for virtual locations (e.g. a Zoom URL venue)

sendInvitesbooleannull— Whether calendar invites are sent to attendees; null if unset

eventTypeIdnumber— ID of the event type this event belongs to

canceledAtstringnull— When the appointment was canceled, as an ISO 8601 timestamp; always null on a fresh create

createdAtstringnull— When the event record was created, as an ISO 8601 timestamp; null when the API omits it on the create echo

updatedAtstringnull— When the event record was last updated, as an ISO 8601 timestamp; null when the API omits it on the create echo

relationshipsobject— JSON:API relationship pointers to related records as {id,type} stubs. Not materialized — follow a pointer by calling that resource's own get/find tool (e.g. type 'prospect' -> get-matter, type 'contact' -> get-contact, type 'user' -> get-user).

eventableobjectnull— The matter/contact the appointment is with (type "prospect" for a matter, "contact"); null when the event is unattached