Contact Tools

The Bizzy MCP server provides 21 tools for managing contacts and their associated data. These tools are organized into four categories: contact management, emails, addresses, and phone numbers.

Contact management

Core tools for creating, reading, updating, and deleting contacts.

createContact

Create a new contact with name, email, phone, and company information. Permission: contacts:write Parameters:

Name	Type	Required	Description
`firstName`	string	No	The contact’s first name
`lastName`	string	No	The contact’s last name
`name`	string	No	Full display name
`company`	string	No	Company or organization affiliation
`jobTitle`	string	No	Job title or role
`title`	string	No	Honorific or prefix (e.g., Mr, Dr)
`picture`	string	No	URL to the contact’s profile picture
`notes`	string	No	Internal notes and comments
`emails`	string[]	No	Array of email addresses
`phoneNumbers`	string[]	No	Array of phone numbers
`addresses`	object[]	No	Array of address objects

Address object:

Name	Type	Required	Description
`country`	string	Yes	Country
`city`	string	Yes	City
`label`	string	No	Label for the address
`address1`	string	No	Address line 1
`address2`	string	No	Address line 2
`state`	string	No	State
`postalCode`	string	No	Postal code

Returns: The created contact object with all associated data.

getContact

Get details of a specific contact by ID. Permission: contacts:read Parameters:

Name	Type	Required	Description
`contactId`	string (UUID)	Yes	The ID of the contact to retrieve

Returns: The contact’s details, such as name, company, job title, and notes, or null if no contact has that ID. Email addresses, phone numbers, and addresses aren’t included; use listContactEmails, listContactPhones, and listContactAddresses to get them.

listContacts

List contacts in the organization, newest first. There’s no name or email filter, so page through results with offset to find a contact. Permission: contacts:read Parameters:

Name	Type	Required	Default	Description
`limit`	number	No	50	Number of contacts to return (1-100)
`offset`	number	No	0	Number of contacts to skip for pagination

Returns:

{
  "contacts": [...],
  "count": 150,
  "limit": 50,
  "offset": 0
}

updateContact

Update an existing contact. Permission: contacts:write Parameters:

Name	Type	Required	Description
`contactId`	string (UUID)	Yes	The ID of the contact to update
`firstName`	string	No	Update the contact’s first name
`lastName`	string	No	Update the contact’s last name
`name`	string	No	Update the full display name
`company`	string	No	Update the company
`jobTitle`	string	No	Update the job title
`title`	string	No	Update the honorific
`picture`	string	No	Update the profile picture URL
`notes`	string	No	Update internal notes

Returns: The updated contact object.

deleteContact

Delete a contact (soft delete). Permission: contacts:delete Parameters:

Name	Type	Required	Description
`contactId`	string (UUID)	Yes	The ID of the contact to delete

Returns: The deleted contact object.

Contact emails

Tools for managing email addresses associated with contacts.

createContactEmail

Create a new email address for a contact. Permission: contacts.emails:write Parameters:

Name	Type	Required	Description
`contactId`	string (UUID)	Yes	The ID of the contact
`email`	string	Yes	The email address
`label`	string	No	Label (e.g., “work”, “personal”)

Returns: The created contact email object.

getContactEmail

Get details of a specific contact email. Permission: contacts.emails:read Parameters:

Name	Type	Required	Description
`emailId`	string (UUID)	Yes	The ID of the email to retrieve

Returns: Contact email object with all details.

listContactEmails

List all email addresses for a specific contact. Permission: contacts.emails:read Parameters:

Name	Type	Required	Description
`contactId`	string (UUID)	Yes	The ID of the contact

Returns:

{
  "emails": [...],
  "count": 3
}

updateContactEmail

Update an existing contact email address. Permission: contacts.emails:write Parameters:

Name	Type	Required	Description
`emailId`	string (UUID)	Yes	The ID of the email to update
`email`	string	No	Update the email address
`label`	string	No	Update the label

Returns: The updated contact email object.

deleteContactEmail

Delete a contact email address. Permission: contacts.emails:delete Parameters:

Name	Type	Required	Description
`emailId`	string (UUID)	Yes	The ID of the email to delete

Returns: The deleted contact email object.

Contact addresses

Tools for managing physical addresses associated with contacts.

createContactAddress

Create a new address for a contact. Permission: contacts.addresses:write Parameters:

Name	Type	Required	Description
`contactId`	string (UUID)	Yes	The ID of the contact
`country`	string	Yes	Country
`city`	string	Yes	City
`label`	string	Yes	Label for the address
`address1`	string	No	Address line 1
`address2`	string	No	Address line 2
`state`	string	No	State
`postalCode`	string	No	Postal code

Returns: The created contact address object.

getContactAddress

Get details of a specific contact address. Permission: contacts.addresses:read Parameters:

Name	Type	Required	Description
`addressId`	string (UUID)	Yes	The ID of the address to retrieve

Returns: Contact address object with all details.

listContactAddresses

List all addresses for a specific contact. Permission: contacts.addresses:read Parameters:

Name	Type	Required	Default	Description
`contactId`	string (UUID)	Yes	-	The ID of the contact
`limit`	number	No	10	Maximum number of results
`offset`	number	No	0	Offset for pagination
`sortOrder`	string	No	”asc”	Sort order (“asc” or “desc”)

Returns: Array of contact address objects.

updateContactAddress

Update an existing contact address. Permission: contacts.addresses:write Parameters:

Name	Type	Required	Description
`addressId`	string (UUID)	Yes	The ID of the address to update
`country`	string	No	Update the country
`city`	string	No	Update the city
`label`	string	No	Update the label
`address1`	string	No	Update address line 1
`address2`	string	No	Update address line 2
`state`	string	No	Update the state
`postalCode`	string	No	Update the postal code

Returns: The updated contact address object.

deleteContactAddress

Delete a contact address. Permission: contacts.addresses:delete Parameters:

Name	Type	Required	Description
`addressId`	string (UUID)	Yes	The ID of the address to delete

Returns: The deleted contact address object.

Contact phone numbers

Tools for managing phone numbers associated with contacts.

createContactPhone

Create a new phone number for a contact. Permission: contacts.phoneNumbers:write Parameters:

Name	Type	Required	Description
`contactId`	string (UUID)	Yes	The ID of the contact
`phoneNumber`	string	Yes	The phone number
`countryCode`	string	Yes	Country code
`nationalNumber`	string	Yes	National number
`label`	string	Yes	Label (e.g., “mobile”, “work”)

Returns: The created contact phone number object.

getContactPhone

Get details of a specific contact phone number. Permission: contacts.phoneNumbers:read Parameters:

Name	Type	Required	Description
`phoneNumberId`	string (UUID)	Yes	The ID of the phone number to retrieve

Returns: Contact phone number object with all details.

listContactPhones

List all phone numbers for a specific contact. Permission: contacts.phoneNumbers:read Parameters:

Name	Type	Required	Default	Description
`contactId`	string (UUID)	Yes	-	The ID of the contact
`limit`	number	No	10	Maximum number of results
`offset`	number	No	0	Offset for pagination
`sortOrder`	string	No	”asc”	Sort order (“asc” or “desc”)

Returns: Array of contact phone number objects.

updateContactPhone

Update an existing contact phone number. Permission: contacts.phoneNumbers:write Parameters:

Name	Type	Required	Description
`phoneNumberId`	string (UUID)	Yes	The ID of the phone number to update
`phoneNumber`	string	No	Update the phone number
`countryCode`	string	No	Update the country code
`nationalNumber`	string	No	Update the national number
`label`	string	No	Update the label

Returns: The updated contact phone number object.

deleteContactPhone

Delete a contact phone number. Permission: contacts.phoneNumbers:delete Parameters:

Name	Type	Required	Description
`phoneNumberId`	string (UUID)	Yes	The ID of the phone number to delete

Returns: The deleted contact phone number object.

Next steps

Message Tools

Manage messages and threads

Authentication

Learn how MCP clients authenticate to the server

Getting Started

Agent resources

Contact management

createContact

getContact

listContacts

updateContact

deleteContact

Contact emails

createContactEmail

getContactEmail

listContactEmails

updateContactEmail

deleteContactEmail

Contact addresses

createContactAddress

getContactAddress

listContactAddresses

updateContactAddress

deleteContactAddress

Contact phone numbers

createContactPhone

getContactPhone

listContactPhones

updateContactPhone

deleteContactPhone

Next steps

Message Tools

Authentication

​Contact management

​createContact

​getContact

​listContacts

​updateContact

​deleteContact

​Contact emails

​createContactEmail

​getContactEmail

​listContactEmails

​updateContactEmail

​deleteContactEmail

​Contact addresses

​createContactAddress

​getContactAddress

​listContactAddresses

​updateContactAddress

​deleteContactAddress

​Contact phone numbers

​createContactPhone

​getContactPhone

​listContactPhones

​updateContactPhone

​deleteContactPhone

​Next steps

Message Tools

Authentication

Contact management

createContact

getContact

listContacts

updateContact

deleteContact

Contact emails

createContactEmail

getContactEmail

listContactEmails

updateContactEmail

deleteContactEmail

Contact addresses

createContactAddress

getContactAddress

listContactAddresses

updateContactAddress

deleteContactAddress

Contact phone numbers

createContactPhone

getContactPhone

listContactPhones

updateContactPhone

deleteContactPhone

Next steps