×

EngageBay MCP

EngageBay MCP Server

Connect an AI tool to your EngageBay account and let it search, count, read, create and update your CRM data in plain language, using 19 tools.

On this page

Implementation overview

The EngageBay MCP server lets your AI assistant answer questions about your CRM. It provides 19 tools for finding, counting and reading records, for creating and updating them, and for reading account details. Your assistant chooses the right tool for each question, so you do not call them yourself.

19
Tools
Read & write
Access type
6
Record types
12
Permissions

Supported data and permissions

What your assistant can read and change depends on the tools above and on the permissions granted to your connection.

Read access

Six record types can be searched, counted and fetched: contacts, companies, deals, products, tasks and appointments. Several tools also read supporting account data.

Companies

Read & write

Organizations and accounts in your CRM.

  • crm.companies.read
  • crm.companies.write

Dedicated tools

Products

Read

Products that can be attached to deals. Read only — products cannot be created or updated.

  • crm.deals.read

Dedicated tools

Tasks

Read & write

Tasks and their owners and due dates.

  • crm.tasks.read
  • crm.tasks.write

Appointments

Read & write

Appointments and meetings, with their start and end times. The object type is calendar_event.

  • crm.appointments.read
  • crm.appointments.write

Supporting data

Account settings

Read

Company name, website, timezone, currency and clock format.

  • account.read

Dedicated tools

Account users

Read

Everyone on the account with id, name, email and role.

  • account.users.read

Dedicated tools

Pipelines and stages

Read

Every deal pipeline and its ordered stages, with ids.

  • crm.deals.read

Dedicated tools

Tags

Read

Tags by prefix, with how many contacts carry each.

  • crm.contacts.read

Dedicated tools

Contact lists

Read

Saved contact lists and their sizes.

  • crm.contacts.read

Dedicated tools

Fields and properties

Read

Field keys, types and allowed values, including custom fields.

  • Per object type

Dedicated tools

Write access

Five record types can be created and updated: contacts, companies, deals, tasks and appointments. Products are read only. A write needs the matching write permission for that record type — crm.contacts.write for contacts, crm.deals.write for deals, and so on.

There is no delete.

The EngageBay MCP server creates records and updates existing ones. It cannot delete anything in your account — no tool removes a record, and no permission grants deletion.

That holds for wildcard permissions too. crm.contacts.*, crm.* and * grant read, create and update only. There is also no account write permission of any kind: account.read and account.users.read are read-only.

What you can set on tasks and appointments

Record typeFields you can setNotes
Taskname description status type priority due_at reminder_atname is required when you create a task. status, type and priority accept only the values configured in your own account settings, so they are not a fixed list — check yours with get_properties. is_due and completed_at are derived by EngageBay and cannot be set.
Appointmentname starts_at ends_atBoth times are required when you create an appointment, and ends_at must be after starts_at. Tasks and appointments cannot be tagged. The owner is set with set_owner, not as a field.

Tasks and appointments attach to contacts, companies and deals with manage_associations, not as a field on the record itself.

Permissions and scopes

Access is checked per record type, using the scopes your connection was granted. You review these on the consent screen when you connect.

PermissionGrantsTools
crm.contacts.readRead contacts, plus tags, contact lists, notes and field definitionssearch_crm_objects count_crm_objects get_crm_objects search_contacts list_object_notes list_contact_lists list_tags get_properties
crm.contacts.writeCreate and update contactscreate_crm_objects update_crm_objects manage_tags set_owner manage_associations create_note
crm.companies.readRead companies, plus notes and field definitionssearch_crm_objects count_crm_objects get_crm_objects search_companies list_object_notes get_properties
crm.companies.writeCreate and update companiescreate_crm_objects update_crm_objects manage_tags set_owner manage_associations create_note
crm.deals.readRead deals and products, plus pipelines, notes and field definitionssearch_crm_objects count_crm_objects get_crm_objects find_deals_by_product list_pipelines list_object_notes get_properties
crm.deals.writeCreate and update deals. Products stay read only — they cannot be created or updated.create_crm_objects update_crm_objects manage_tags set_owner manage_associations create_note
crm.tasks.readRead taskssearch_crm_objects count_crm_objects get_crm_objects
crm.tasks.writeCreate and update taskscreate_crm_objects update_crm_objects set_owner manage_associations
crm.appointments.readRead appointmentssearch_crm_objects count_crm_objects get_crm_objects
crm.appointments.writeCreate and update appointmentscreate_crm_objects update_crm_objects set_owner manage_associations
account.readRead basic account informationget_account_info
account.users.readRead the list of users on the accountlist_users

Less access is handled gracefully. If your connection wasn’t granted the permission for a record type, the tool returns a clear refusal naming the missing permission, not an empty result that looks like a real answer.

Counts and searches only include records you have permission to see. If your access is scoped to specific owners or teams in EngageBay, results reflect that scope, not the account-wide total.

Available tools

Select a tool to see its parameters, examples, limits and troubleshooting. Permission shown as “per object type” means the read or write permission for the record type you are working with.

Search and retrieve 6

ToolWhat it doesPermission
search_crm_objectsFind the records that match a specific condition — contacts, companies, deals, products, tasks, or appointments — using precise filters rather than a free-text guess. This is the tool your assistant reaches for on almost any “which records…” question.Per object type
count_crm_objectsGet an exact count of the records that match a filter — contacts, companies, deals, products, tasks, or appointments — without pulling back the records themselves. This is the tool for every “how many…” question.Per object type
get_crm_objectsFetch full, current detail on specific records — up to 50 in one call — once you already know their ids or a contact's email address. This is the tool for “tell me everything about this record,” not for finding records in the first place.Per object type
search_contactsFind contacts with a free-text keyword — a name, an email, a phone number, or a fragment of one — when you don't have a structured condition to filter on, just something you remember about the person.crm.contacts.read
search_companiesFind companies with a free-text keyword — a name, a website, an email domain, or a fragment of one — when you don't have a structured condition to filter on, just something you remember about the company.crm.companies.read
find_deals_by_productFind every deal that includes a specific product — for questions like “which deals include the Starter Plan?” that a regular record filter can't answer directly.crm.deals.read

Notes 1

ToolWhat it doesPermission
list_object_notesRead the notes recorded against one record — a contact, company or deal — newest first, what your team wrote by hand.Per object type

Account metadata 5

ToolWhat it doesPermission
get_account_infoGet your account's company name, website, timezone, currency, and clock format — the context that makes phrases like “today” or “closing this week” resolve to the right dates.account.read
list_contact_listsSee every contact list on the account and how many contacts are in each — a saved grouping of contacts, distinct from a tag.crm.contacts.read
list_pipelinesGet every deal pipeline and its stages, in order — the lookup that makes stage-based deal filters actually work, since stage names repeat across pipelines but ids don't.crm.deals.read
list_tagsLook up tags by prefix, with how many contacts carry each one — the way to confirm exact spelling before filtering, since tag matches are exact and case-sensitive.crm.contacts.read
list_usersGet the id, name, email, and role for everyone on the account — the step that turns a person's name into the owner id a filter actually needs.account.users.read

Schema and discovery 1

ToolWhat it doesPermission
get_propertiesLook up the exact field names, data types, and allowed values for any EngageBay record type — including your own custom fields — before you search, filter, or ask your assistant a question that depends on a specific field.Per object type

Create and update 6

ToolWhat it doesPermission
create_crm_objectsCreate new records — contacts, companies, deals, tasks or appointments — up to 50 in one call. Products cannot be created.Per object type
update_crm_objectsUpdate fields on records that already exist — contacts, companies, deals, tasks or appointments — up to 50 in one call. Products cannot be updated.Per object type
manage_associationsLink and unlink records: attach a task or an appointment to a contact, a company or a deal, or remove that link.Per object type
manage_tagsAdd and remove tags on contacts, companies and deals. Tasks and appointments cannot be tagged.Per object type
set_ownerSet which user on your account owns a record.Per object type
create_noteAdd a note to a contact, a company or a deal.Per object type

None of these tools deletes anything. They create records and change records that already exist. Removing a record is not something the EngageBay MCP server can do, whatever permissions you grant it.

How the tools work together

Most questions use more than one tool. Your assistant chains them automatically, but it helps to know what happens behind the scenes.

Resolve names to ids

Filters match ids, never names. list_users turns a person into an owner id, list_pipelines gives the pipeline id a stage filter needs as track_id, and list_tags confirms exact, case-sensitive tag spelling.

Example: “How many tasks are overdue for Priya?”

Check field keys first

get_properties returns each field’s key, label, type, allowed options and whether it is filterable. Filters use keys, not the labels you see in the app.

Example: “Do we have a custom field for renewal date on deals?”

Find, count or fetch

search_crm_objects finds records (up to 50 per page, no total). count_crm_objects returns an exact count with the same filters. get_crm_objects reads full, current detail for up to 50 ids.

Example: “How many deals are at Negotiation in the Sales pipeline?”

Get the time context

Every timestamp is in UTC. get_account_info returns the account timezone so phrases like “today” or “last week” resolve to the right dates.

Example: “How many contacts did we add today?”

Example prompts

Ask questions like these once you are connected.

Which deals in the Sales pipeline are still at Negotiation?

Uses search_crm_objects

How many contacts did we add last week?

Uses count_crm_objects

Show me the contact with email [email protected] and the notes on them.

Uses get_crm_objects

Add a follow-up task for Priya, due Friday.

Uses create_crm_objects

Which deals include the Starter Plan product?

Uses find_deals_by_product

How many tasks are overdue for Priya?

Uses count_crm_objects

Connect a client

Choose your AI tool for setup instructions. When you sign in, review the consent screen to see the permissions your connection is granted.

Ready to connect your AI tools to EngageBay?

Create a free account, pick your AI tool and start asking questions about your CRM.

This website uses cookies to ensure you get the best experience on our website. Learn more about EngageBay's legal policies