Integration · Communication

Connect Claude & ChatGPT to Heyy

Ask your AI which Heyy chats are still open, and it searches your conversations across your connected channels. It can reply in a chat, send an approved message template, assign chats to a team or a colleague and close or snooze them. It can also find and update contacts, add labels and run an automation for a contact.

Connect Heyy free

Free plan, no credit card. Takes about a minute.

Try asking

“Which open chats are not assigned to anyone?”
The AI searches your chats with a filter and lists the open ones with their contact and assignee.
“Reply to Maria's chat that her order ships tomorrow.”
It finds the chat and sends the reply. This is a real message to the customer, so you can require approval first.
“Send the appointment reminder template to Jonas.”
It finds the approved template and Jonas's chat, fills in the template variables and sends it.

What your AI can do

Chats and messages

Search and read chats, send replies and approved templates, assign chats to teams or people, and set them open, closed or snoozed.

Contacts and labels

Search, create and update contacts with labels and custom attributes, create labels and unsubscribe a contact from marketing.

Automations and campaigns

Search automations and run one for a contact, look up broadcast campaigns, and see your channels, teams and users.

“Assign all chats about returns to the support team.”
It searches the chats, finds the support team's ID and assigns each chat to that team.
“Add the label VIP to Sofie Hansen and save her company as Nordhavn ApS.”
It finds the contact, adds the label and updates her custom attributes.
“Start the welcome flow for the contact we just added.”
It finds the automation and runs it for that contact, now or at a time you set. The flow may send messages to the contact.

72 tools for Heyy

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

add_contact_labelsChanges dataAdd one or more `labels` to a contact by `contact_id`.
assign_chat_to_teamChanges dataAssign a chat (`chat_id`) to a team (`team_id`).
assign_chat_to_userChanges dataAssign a chat (`chat_id`) to a team member (`user_id`).
create_api_webhookDeletesCreate a new api webhook. Required: url or events. Search api webhooks first to avoid duplicates. Destructive action; may require approval. API summary: Create API webhook.
create_attributeChanges dataCreate a new attribute. Required: type, display name or visibility. Search attributes first to avoid duplicates. API summary: Create attribute.
create_automation_pauseChanges dataCreate a new pause for a automation. API summary: Pause automation.
create_automation_unpauseChanges dataCreate a new unpause for a automation. API summary: Unpause automation.
create_bulkVisible to othersCreate a new bulk. Required: contacts. Has effects visible outside this system. API summary: Bulk upsert contacts.
create_campaignChanges dataCreate a new campaign. Required: name or automation id. Search campaigns first to avoid duplicates. API summary: Create campaign.
create_campaign_recipientChanges dataCreate a new recipient for a campaign. Required: contact ids. API summary: Add recipients.
create_campaign_startChanges dataCreate a new start for a campaign. API summary: Start campaign.
create_contactChanges dataCreate a new contact. Search contacts first to avoid duplicates. API summary: Create contact.
create_contact_subscribeChanges dataCreate a new subscribe for a contact. API summary: Subscribe contact.
create_documentChanges dataCreate a new document. Required: type or file. API summary: Upload file.
create_journey_subscribeChanges dataCreate a new subscribe for a journey. Required: contact ids. API summary: Subscribe contacts to journey.
create_journey_unsubscribeChanges dataCreate a new unsubscribe for a journey. Required: contact ids. API summary: Unsubscribe contacts from journey.
create_labelChanges dataCreate a new contact label with a `name` and `color`.
create_message_templateVisible to othersCreate a new message template. Required: body. Search message templates first to avoid duplicates. Has effects visible outside this system. API summary: Create message template.
create_or_update_contactChanges dataCreate a contact, or update the existing one with the same phone number or email, with first/last name, `phone_number`, `email`, `labels` and custom `attributes`.
create_teamChanges dataCreate a new team. Required: icon or name. Search teams first to avoid duplicates. API summary: Create team.
delete_api_webhookDeletesPermanently delete a api webhook by webhook id. Destructive action; may require approval. API summary: Delete API webhook.
delete_attributeDeletesPermanently delete a attribute by attribute id. Destructive action; may require approval. API summary: Delete attribute.
delete_campaignDeletesPermanently delete a campaign by campaign id. Destructive action; may require approval. API summary: Delete campaign.
delete_campaign_recipientsMoves moneyPermanently delete a recipient by campaign id. Financial or irreversible action; may require approval. API summary: Remove recipients.
delete_chatDeletesPermanently delete a chat by chat id. Destructive action; may require approval. API summary: Delete chat.
delete_contactDeletesPermanently delete a contact by contact id. Destructive action; may require approval. API summary: Delete contact.
delete_contact_labelsMoves moneyPermanently delete a label by contact id. Financial or irreversible action; may require approval. API summary: Remove labels from contact.
delete_labelDeletesPermanently delete a label by label id. Destructive action; may require approval. API summary: Delete label.
delete_message_templateDeletesPermanently delete a message template by message template id. Destructive action; may require approval. API summary: Delete message template.
delete_teamDeletesPermanently delete a team by team id. Destructive action; may require approval. API summary: Delete team.
get_attributeGet one attribute by attribute id. API summary: Get attribute.
get_automationGet one automation by automation id. API summary: Get automation.
get_campaignGet one campaign by `campaign_id`, including schedule and audience.
get_channelGet one channel by channel id. API summary: Get channel.
get_chatGet one chat by `chat_id`, including its contact, channel, status and assignee.
get_contactGet one contact by `contact_id`, including name, phone, email, labels and attributes.
get_documentGet one document by document id. API summary: Get file.
get_journeyGet one journey by journey id. API summary: Get journey.
get_labelGet one label by label id. API summary: Get label.
get_message_templateGet one message template by message template id. API summary: Get message template.
get_teamGet one team by team id. API summary: Get team.
get_userGet one user by user id. API summary: Get user.
get_workspaceGet the connected Heyy workspace's details.
list_document_public_urlsList public urls for a document. API summary: Get public file URL.
list_usersList the team members (users) in the workspace. Use it to find a user ID for assigning chats.
mark_chat_as_readVisible to othersMark a chat as read by `chat_id`.
mark_chat_as_unreadVisible to othersMark a chat as unread by `chat_id`.
search_api_webhooksDeletesSearch api webhooks. Use this to find existing api webhooks before creating a new api webhook. Destructive action; may require approval.
search_attributesChanges dataSearch attributes. Use this to find existing attributes before creating a new attribute.
search_automationsChanges dataSearch automations (message flows) with `search` or a `query` filter.
search_campaignsChanges dataSearch broadcast campaigns with `search` or a `query` filter.
search_channelsChanges dataSearch the workspace's connected messaging channels (for example WhatsApp numbers) with `search` or a `query` filter.
search_chatsChanges dataSearch chats (conversations) with free text in `search` or a structured `query` filter, with optional `sort_by` and `pagination`. Use it to find a chat before replying.
search_contactsChanges dataSearch contacts by free text in `search` (name, phone number or email) or a structured `query` filter, with optional `sort_by` and `pagination` (page, limit). Use it to find a contact's ID.
search_journeysChanges dataSearch journeys. Use this to find existing journeys before creating a new journey.
search_labelsChanges dataSearch contact labels with `search` or a `query` filter. Use it to find label IDs.
search_message_templatesVisible to othersSearch the workspace's message templates with free text in `search` or a `query` filter. Use it to find a template ID before sending.
search_teamsChanges dataSearch teams with `search` or a `query` filter. Use it to find a team ID for assigning chats.
send_messageVisible to othersSend a message into a chat. `chat` identifies the conversation (find it with search_chats); add `body` text, optional header, footer, attachments, a `reply_to_message_id`, or `scheduled_at` to send later. This sends a real message to the customer.
send_template_messageVisible to othersSend an approved message template into a chat, with `message_template.id` and its `variables`; `chat` identifies the conversation. Use this to start conversations outside the reply window. This sends a real message to the customer.
set_chat_statusChanges dataChange a chat's `status` to open, closed or snoozed by `chat_id`.
submit_chat_mark_as_not_sensitiveVisible to othersMark as not sensitive a chat (chat id). Has effects visible outside this system. API summary: Mark chat as not sensitive.
submit_chat_mark_as_sensitiveVisible to othersMark as sensitive a chat (chat id). Has effects visible outside this system. API summary: Mark chat as sensitive.
trigger_automationChanges dataRun an automation (`automation_id`) for one contact (`contact_id`), with optional `variables` and `scheduled_at`. The automation may send messages to the contact.
unsubscribe_contactChanges dataUnsubscribe a contact by `contact_id` so they stop receiving marketing messages.
update_api_webhookDeletesUpdate an existing api webhook identified by webhook id. Destructive action; may require approval. API summary: Update API webhook.
update_attributeChanges dataUpdate an existing attribute identified by attribute id. API summary: Update attribute.
update_campaignChanges dataUpdate an existing campaign identified by campaign id. API summary: Update campaign.
update_contactChanges dataUpdate a contact's first name, last name or custom `attributes` by `contact_id`. Only the fields you pass change.
update_labelChanges dataUpdate an existing label identified by label id. API summary: Update label.
update_message_templateVisible to othersUpdate an existing message template identified by message template id. Has effects visible outside this system. API summary: Update message template.
update_teamChanges dataUpdate an existing team identified by team id. API summary: Update team.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose Heyy from the app list.
2
Paste your key
Paste a Heyy API key. In Heyy open Settings › API Keys, click Create API key, give it a name and click Create. Copy the key right away. It is shown only once.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Heyy?

The AI can search and read chats, contacts, labels, teams, channels, message templates, automations and campaigns, and list your users. It can send messages and templates, assign chats, change chat status, mark chats read or unread, create and update contacts, add labels, unsubscribe a contact and run an automation for a contact.

Does the AI see my Heyy API key?

No. Your Heyy API key is encrypted at rest and never shown to the AI. After you save it, it is not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start with searching chats and contacts only. Sending a message or template reaches a real customer, and an automation may send messages too, so these can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

HeyMyApps has a free plan with no credit card required. Paid plans bill per completed task. You also need your own Heyy account.

Can the AI start a conversation with a customer?

Yes, with an approved message template. send_message replies inside an existing chat, and send_template_message sends an approved template, which is what you use to start a conversation outside the reply window. The AI can search your templates to find the right one.