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.

26 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_labelChanges dataCreate a new contact label with a `name` and `color`.
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`.
get_campaignGet one campaign by `campaign_id`, including schedule and audience.
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_workspaceGet the connected Heyy workspace's details.
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_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_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`.
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_contactChanges dataUpdate a contact's first name, last name or custom `attributes` by `contact_id`. Only the fields you pass change.

Set up in three steps

1
Pick the app
Create a free PipMCP 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 PipMCP 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?

PipMCP 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.