Lawmatics MCP Tool - Create Contact

Q: What does the Create Contact tool do?

This page documents the Create Contact tool (lawmatics_create-contact). Create a contact in Lawmatics. The response echoes standard fields, custom fields, and a relationships envelope of {id,type} pointers to related records (creating user, client, company, custom contact type, matters, tags, emails, phone numbers, addresses, notes, files, folders). It is one of the Lawmatics Contacts tools, invoked through your firm's Weave MCP connection and available to members whose access level permits it.

Create Contact (lawmatics_create-contact)

Create a contact in Lawmatics. The response echoes standard fields, custom fields, and a `relationships` envelope of {id,type} pointers to related records (creating user, client, company, custom contact type, matters, tags, emails, phone numbers, addresses, notes, files, folders).

Tool Input

firstNamestring— Contact's first name

lastNamestring— Contact's last name

emailstring— Primary email address

phonestring— Primary phone number

namePrefixstring— Name prefix (e.g. Mr, Ms, Dr)

middleNamestring— Middle name

nameSuffixstring— Name suffix (e.g. Jr, Sr, III)

informalNamestring— Informal name / nickname

socialSecuritystring— Social security number

driverLicensestring— Driver license number

maritalStatusstring— Marital status

birthdatestring(date)— Date of birth as an ISO 8601 date (YYYY-MM-DD)(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])))$)

employerstring— Employer or organization name

occupationstring— Occupation or job role

citizenshipstring— Citizenship

genderstring— Gender

timezonestring— Timezone identifier as stored by Lawmatics

hobbiesstring— Free-text hobbies or interests

biostring— Free-text biography or notes about the contact

titlestring— Job title

notesarray— Notes to create inline with the contact (write-only; not returned)

[]object

namestring— Note title

bodystring— Note content

customFieldsarray— Custom field values to set on the contact

[]object

idstringnumber— Custom field ID (the API returns it as a number; either a string or number is accepted)

valuestringnumberbooleannull— Value to set (matches the field's type); pass null to clear the field

Tool Output

idstring— Lawmatics contact ID of the newly created contact

firstNamestringnull— Contact's first/given name; null if unset

lastNamestringnull— Contact's last/family name; null if unset

emailstringnull— Primary email address; null if unset

phonestringnull— Primary phone number as stored; null if unset

customFieldsarray— Account-defined custom fields on the contact; empty array if none

[]object

idstring— Custom field definition ID, as a numeric string

namestringnull— Custom field display name; null if unset

fieldTypestringnull— Custom field data type (e.g. text, date, select); null if unset

valueany— Raw custom field value; type varies by `fieldType`

formattedValueany— Display-formatted custom field value; type varies by `fieldType`

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 'user' -> get-user, type 'company' -> get-company).

createdByobjectnull— Creating user pointer; null when unset