Integration · Customer support

Connect Claude & ChatGPT to Help Scout

Ask your AI to read a Help Scout conversation, find the right saved reply and answer the customer or leave a note for your team. It can look up customers and organizations, move and assign conversations, and pull reports on volume, response times and customer happiness.

Connect Help Scout free

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

Try asking

“How many conversations are waiting in Unassigned and Needs Attention in our Support mailbox?”
The AI finds the mailbox and lists its folders with conversation counts.
“Read the latest conversation from [email protected] and draft a reply using our refund saved reply.”
It finds the conversation by customer email, reads every thread, fetches the saved reply text and saves a draft reply for you to review.
“Add an internal note on conversation 1234: waiting on the dev team, follow up Friday.”
It adds a note to the conversation that only your team can see.

What your AI can do

Conversations and replies

Read full threads, reply to customers or save drafts, add internal notes, and change status, assignee or mailbox.

Customers and organizations

Find, create and update customers and organizations, and list every conversation from one company.

Team reports

Pull conversation volume, productivity and happiness reports for any date range, filtered by mailbox or tag.

“Assign all pending conversations tagged billing to Lars.”
It lists pending conversations with the billing tag, finds Lars among your users and sets him as assignee on each one.
“How did our first response time and resolution time look last month?”
It pulls the productivity report for last month with first response time, resolution time and replies sent.
“What was our happiness score in Q3, and which tags were busiest?”
It combines the happiness report with the conversations report and gives you the score, the split of ratings and the top tags.

152 tools for Help Scout

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

add_messageVisible to othersUpdate an existing message identified by message id. Has effects visible outside this system. API summary: Add Message.
add_noteChanges dataAdd an internal note to a conversation by conversation_id. Notes are only visible to your team.
add_note_2Changes dataUpdate an existing message identified by message id. API summary: Add Note.
assign_chatChanges dataAssign a chat (chat id). API summary: Assign Chat.
create_addressChanges dataCreate a new address for a customer. Required: city, state, postal code or country. API summary: Create Address.
create_article_assetChanges dataCreate a new product. API summary: Create Article Asset.
create_chat_handleChanges dataCreate a new chat for a customer. Required: type or value. API summary: Create Chat Handle.
create_chat_threadChanges dataCreate a new chat for a message. Required: text or customer. API summary: Create Chat Thread.
create_conversationChanges dataStart a new conversation in a mailbox. Requires subject, customer, mailbox_id, type (email, phone, chat), status and at least one thread. An outgoing reply thread emails the customer.
create_customerChanges dataCreate a customer with first name, last name and emails. Search first to avoid duplicates.
create_customer_property_definitionChanges dataCreate a new property. Required: type, slug or name. API summary: Create Customer Property Definition.
create_customer_threadChanges dataCreate a new customer for a message. Required: text or customer. Search customers first to avoid duplicates. API summary: Create Customer Thread.
create_emailChanges dataCreate a new message for a customer. Required: type or value. Search messages first to avoid duplicates. API summary: Create Email.
create_organizationChanges dataCreate an organization with a name and optional domains, website and description.
create_organization_property_definitionChanges dataCreate a new property. Required: type, slug or name. API summary: Create Organization Property Definition.
create_phoneChanges dataCreate a new phone for a customer. Required: type or value. API summary: Create Phone.
create_phone_threadChanges dataCreate a new phone for a message. Required: text or customer. API summary: Create Phone Thread.
create_saved_replyChanges dataCreate a new saved reply for a mailbox. Required: name. API summary: Create Saved Reply.
create_social_profileChanges dataCreate a new social profile for a customer. Required: type or value. API summary: Create Social Profile.
create_userChanges dataCreate a new user. Required: first name, last name, email or role. Search users first to avoid duplicates. API summary: Create User.
create_webhookDeletesCreate a new webhook. Required: url, events or secret. Destructive action; may require approval. API summary: Create Webhook.
create_websiteChanges dataCreate a new website for a customer. Required: value. API summary: Create Website.
delete_addressMoves moneyPermanently delete a address by customer id. Financial or irreversible action; may require approval. API summary: Delete Address.
delete_attachmentDeletesPermanently delete a document by document id. Destructive action; may require approval. API summary: Delete Attachment.
delete_chat_handleDeletesPermanently delete a chat by chat id. Destructive action; may require approval. API summary: Delete Chat Handle.
delete_conversationDeletesPermanently delete a message by message id. Destructive action; may require approval. API summary: Delete Conversation.
delete_customerDeletesPermanently delete a customer by customer id. Destructive action; may require approval. API summary: Delete Customer.
delete_customer_property_definitionDeletesPermanently delete a property by property slug. Destructive action; may require approval. API summary: Delete Customer Property Definition.
delete_emailDeletesPermanently delete a message by message id. Destructive action; may require approval. API summary: Delete Email.
delete_organization_by_idDeletesPermanently delete a company by company id. Destructive action; may require approval. API summary: Delete Organization by ID.
delete_organization_property_definitionDeletesPermanently delete a property by property slug. Destructive action; may require approval. API summary: Delete Organization Property Definition.
delete_phoneDeletesPermanently delete a phone by phone id. Destructive action; may require approval. API summary: Delete Phone.
delete_saved_replyDeletesPermanently delete a saved reply by saved reply id. Destructive action; may require approval. API summary: Delete Saved Reply.
delete_snoozeMoves moneyPermanently delete a snooze by conversation id. Financial or irreversible action; may require approval. API summary: Delete Snooze.
delete_social_profileDeletesPermanently delete a social profile by social profile id. Destructive action; may require approval. API summary: Delete Social Profile.
delete_thread_scheduleMoves moneyPermanently delete a schedule by thread id. Financial or irreversible action; may require approval. API summary: Delete Thread Schedule.
delete_userDeletesPermanently delete a user by user id. Destructive action; may require approval. API summary: Delete User.
delete_webhookDeletesPermanently delete a webhook by webhook id. Destructive action; may require approval. API summary: Delete Webhook.
delete_websiteDeletesPermanently delete a website by website id. Destructive action; may require approval. API summary: Delete Website.
download_attachment_fileList documents for a attachment. API summary: Download Attachment File.
get_addressList addresses for a customer. API summary: Get Address.
get_all_channels_volumes_by_channelList volume by channels. Optional filters: start, end, previous start, previous end, mailboxes or tags. API summary: All Channels - Volumes by Channel.
get_attachment_dataList data for a attachment. API summary: Get Attachment Data.
get_chatGet one chat by chat id. API summary: Get Chat.
get_chat_eventsList events for a chat. Results are paginated. API summary: Get Chat Events.
get_chat_reportList chats. Optional filters: start, end, previous start, previous end, mailboxes or tags. API summary: Chat Report.
get_company_customers_helpedList customers helpeds. Optional filters: start, end, previous start, previous end, mailboxes or tags. API summary: Company Customers Helped.
get_company_drilldownList drilldowns. Optional filters: start, end, mailboxes, tags, types or folders. Results are paginated. API summary: Company Drilldown.
get_company_overall_reportList companies. Optional filters: start, end, previous start, previous end, mailboxes or tags. API summary: Company Overall Report.
get_conversationGet one conversation by conversation_id: subject, status, customer, assignee, tags and mailbox. Use list_conversation_threads to read the messages.
get_conversation_reassignment_configurationList conversation reassignments for a user. API summary: Get Conversation Reassignment configuration.
get_conversation_v3Get one message by message id. API summary: Get Conversation (v3).
get_conversations_busiest_time_of_dayList busy times. Optional filters: start, end, previous start, previous end, mailboxes or tags. API summary: Conversations - Busiest Time of Day.
get_conversations_drilldownList drilldowns. Optional filters: start, end, mailboxes, tags, types or folders. Results are paginated. API summary: Conversations - Drilldown.
get_conversations_drilldown_by_fieldList fields drilldowns. Optional filters: start, end, field, fieldid, mailboxes or tags. Results are paginated. API summary: Conversations - Drilldown by Field.
get_conversations_new_conversationsList news. Optional filters: start, end, previous start, previous end, mailboxes or tags. API summary: Conversations - New Conversations.
get_conversations_new_conversations_drilldownChanges dataCreate a new message. Search messages first to avoid duplicates. Results are paginated. API summary: Conversations - New Conversations Drilldown.
get_conversations_received_messages_statisticsList messages. Optional filters: start, end, previous start, previous end, mailboxes or tags. API summary: Conversations - Received Messages Statistics.
get_conversations_reportGet conversation volume stats (new, closed, busiest days, top tags) for a start/end date range, optionally filtered by mailboxes or tags.
get_current_userGet the Help Scout user this connection is signed in as.
get_customerGet one customer by customer_id: name, emails, phones, organization and custom properties.
get_docs_overall_reportList docs. Optional filters: start, end, previous start, previous end or sites. API summary: Docs Overall Report.
get_email_reportVisible to othersEmail a report. Has effects visible outside this system. API summary: Email Report.
get_happiness_ratings_reportList ratings. Optional filters: start, end, previous start, previous end, mailboxes or tags. Results are paginated. API summary: Happiness Ratings Report.
get_happiness_reportGet customer satisfaction ratings (great, okay, not good) and happiness score for a start/end date range.
get_mailboxGet one mailbox by mailbox_id: name and email address.
get_organizationGet one organization by organization_id: name, domains, description and properties.
get_organization_customersList customers for a company. Results are paginated. API summary: Get Organization Customers.
get_organization_property_definitionGet one property by property slug. API summary: Get Organization Property Definition.
get_phone_reportList phones. Optional filters: start, end, previous start, previous end, mailboxes or tags. API summary: Phone Report.
get_productivity_first_response_timeList first response times. Optional filters: start, end, previous start, previous end, mailboxes or tags. API summary: Productivity - First Response Time.
get_productivity_replies_sentList replies sents. Optional filters: start, end, previous start, previous end, mailboxes or tags. API summary: Productivity - Replies Sent.
get_productivity_reportGet team productivity stats (first response time, resolution time, replies sent) for a start/end date range.
get_productivity_resolution_timeList resolution times. Optional filters: start, end, previous start, previous end, mailboxes or tags. API summary: Productivity - Resolution Time.
get_productivity_resolvedList resolveds. Optional filters: start, end, previous start, previous end, mailboxes or tags. API summary: Productivity - Resolved.
get_productivity_response_timeList response times. Optional filters: start, end, previous start, previous end, mailboxes or tags. API summary: Productivity - Response Time.
get_routing_configurationList routings for a mailbox. API summary: Get Routing configuration.
get_satisfaction_ratingGet one rating by rating id. API summary: Get Satisfaction Rating.
get_saved_replyGet the full text of a saved reply by mailbox_id and saved_reply_id.
get_system_userGet one user by user id. API summary: Get System User.
get_thread_original_sourceList original sources for a thread. API summary: Get Thread Original Source.
get_userGet one user by user id. API summary: Get User.
get_user_conversation_historyList conversation histories. Optional filters: user, start, end, previous start, previous end or status. Results are paginated. API summary: User Conversation History.
get_user_customers_helpedList customers helpeds. Optional filters: user, start, end, previous start, previous end or mailboxes. API summary: User Customers Helped.
get_user_drill_downList drilldowns. Optional filters: start, end, user, mailboxes, tags or types. Results are paginated. API summary: User Drill-down.
get_user_happinessList happinesses. Optional filters: user, start, end, previous start, previous end or mailboxes. API summary: User Happiness.
get_user_happiness_drilldownList ratings. Optional filters: user, start, end, previous start, previous end or mailboxes. Results are paginated. API summary: User Happiness drilldown.
get_user_repliesList replies. Optional filters: user, start, end, previous start, previous end or mailboxes. API summary: User Replies.
get_user_resolutionsList resolutions. Optional filters: user, start, end, previous start, previous end or mailboxes. API summary: User Resolutions.
get_user_statusGet the current status of a user by user id. API summary: Get user status.
get_user_team_chat_reportList chats. Optional filters: user, start, end, previous start, previous end or mailboxes. API summary: User/Team Chat Report.
get_user_team_overall_reportList users. Optional filters: user, start, end, previous start, previous end or mailboxes. API summary: User/Team Overall Report.
get_webhookGet one webhook by webhook id. API summary: Get Webhook.
list_categoriesList categories. API summary: Overview.
list_chats_handlesList chats for a customer. API summary: List Chats Handles.
list_conversation_threadsList all threads (customer messages, replies and notes) in a conversation, by conversation_id. Use it to read the full conversation.
list_conversationsFind conversations. Filter by inbox id, customer email or contact id, status (active, pending, closed, spam), tag or assigned user. Results are paginated.
list_conversations_2Search messages by embed, mailbox, folder, status, tag or assigned to. Use this to find existing messages before creating a new message. Results are paginated. API summary: List Conversations.
list_customer_property_definitionsList properties. API summary: List Customer Property Definitions.
list_customersFind customers by first name, last name, email or free-text query, or by created/modified date.
list_customers_2Search customers by mailbox, first name, last name, modified since, sort field or sort order. Use this to find existing customers before creating a new customer. Results are paginated. API summary: List Customers.
list_emailsList messages for a customer. API summary: List Emails.
list_inbox_custom_fieldsList fields for a mailbox. API summary: List Inbox Custom Fields.
list_mailbox_foldersList folders in a mailbox (Unassigned, Mine, Needs Attention...) with conversation counts, by mailbox_id.
list_mailboxesList mailboxes (inboxes) with their IDs. You need a mailbox ID to create conversations or read saved replies.
list_mailboxes_jsonsList mailboxes jsons. API summary: Overview.
list_organization_conversationsList conversations from customers who belong to an organization, by organization_id.
list_organization_property_definitionsList properties. API summary: List Organization Property Definitions.
list_organizationsList organizations (customer companies).
list_phonesList phones for a customer.
list_saved_repliesList saved replies (canned responses) in a mailbox, by mailbox_id.
list_social_profilesList social profiles for a customer.
list_system_usersList users. Results are paginated. API summary: List System Users.
list_team_membersList users for a team. Results are paginated. API summary: List Team Members.
list_teamsList teams. Results are paginated.
list_threads_v3List threads for a message. API summary: List Threads (v3).
list_usersList Help Scout users (agents). Filter by email or mailbox. Use it to find the user ID for assigning conversations.
list_users_statusesGet the current status of a user. Results are paginated. API summary: List users statuses.
list_webhooksList webhooks.
list_websitesList websites for a customer.
list_workflowsList workflows. Optional filters: mailbox id or type. Results are paginated.
publish_thread_scheduleVisible to othersUpdate an existing schedule identified by thread id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Publish Thread Schedule.
remove_organization_property_valueDeletesPermanently delete a property by property slug. Destructive action; may require approval. API summary: Remove Organization Property Value.
reply_to_conversationChanges dataSend a reply in a conversation by conversation_id with text and the customer. The reply is emailed to the customer unless draft is true.
run_manual_workflowsChanges dataCreate a new run for a workflow. Required: conversation ids. API summary: Run Manual Workflows.
set_organization_property_valueChanges dataUpdate an existing property identified by property slug. API summary: Set Organization Property Value.
set_user_statusChanges dataGet the current status of a user by user id. API summary: Set user status.
update_accept_chatVisible to othersAccept a chat (chat id). Has effects visible outside this system. API summary: Accept Chat.
update_addressVisible to othersUpdate an existing address identified by customer id. Has effects visible outside this system. API summary: Update Address.
update_chat_handlesChanges dataUpdate an existing chat identified by chat id. API summary: Update Chat Handles.
update_conversationChanges dataChange a conversation by conversation_id with a patch operation: status, assignee, subject, mailbox (move) or customer.
update_conversation_reassignment_configurationVisible to othersUpdate an existing conversation reassignment identified by user id. Has effects visible outside this system. API summary: Update Conversation Reassignment configuration.
update_custom_fieldsVisible to othersUpdate an existing field identified by conversation id. Has effects visible outside this system. API summary: Update Custom Fields.
update_customerChanges dataUpdate a customer's core fields (name, job title, location, background) by customer_id. Emails and phones are managed separately.
update_customer_propertiesVisible to othersUpdate an existing property identified by customer id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update Customer Properties.
update_emailVisible to othersUpdate an existing message identified by message id. Has effects visible outside this system. API summary: Update Email.
update_end_chatVisible to othersUpdate an existing end identified by chat id. Has effects visible outside this system. API summary: End Chat.
update_organizationChanges dataUpdate an organization by organization_id, e.g. name, domains or description.
update_organization_property_definitionChanges dataUpdate an existing property identified by property slug. API summary: Update Organization Property Definition.
update_phoneChanges dataUpdate an existing phone identified by phone id. API summary: Update Phone.
update_routing_configurationVisible to othersUpdate an existing routing identified by mailbox id. Has effects visible outside this system. API summary: Update Routing configuration.
update_saved_replyChanges dataUpdate an existing saved reply identified by saved reply id. API summary: Update Saved Reply.
update_snoozeVisible to othersUpdate an existing snooze identified by conversation id. Has effects visible outside this system. API summary: Update Snooze.
update_social_profileChanges dataUpdate an existing social profile identified by social profile id. API summary: Update Social Profile.
update_team_membersVisible to othersUpdate an existing user identified by team id. Has effects visible outside this system. API summary: Update Team Members.
update_threadChanges dataUpdate an existing thread identified by thread id. Only the fields you pass are changed. API summary: Update Thread.
update_unassign_chatChanges dataUnassign a chat (chat id). API summary: Unassign Chat.
update_webhookDeletesUpdate an existing webhook identified by webhook id. Destructive action; may require approval. API summary: Update Webhook.
update_websiteChanges dataUpdate an existing website identified by website id. API summary: Update Website.
update_workflow_statusChanges dataUpdate an existing workflow identified by workflow id. Only the fields you pass are changed. API summary: Update workflow status.
upload_articleChanges dataUpload a product. API summary: Upload Article.
upload_attachmentChanges dataCreate a new document for a thread. Required: file name, mime type or data. API summary: Upload Attachment.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose Help Scout from the app list.
2
Paste your key
In Help Scout, open your profile → Account → My Apps → Create My App. Do not use Workspace → Apps: that creates a sidebar widget. Name the app HeyMyApps and enter https://heymyapps.com if a Redirection URL is required; this connection does not use redirects. Copy the App ID and App Secret into HeyMyApps and click Connect Help Scout. If you see Content URL or Content signature key, return to My Apps. Requires an active Help Scout user and HeyMyApps Pro or above.
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 Help Scout?

The AI can list and read conversations and their threads, reply, add notes, and change status, assignee, subject or mailbox. It can find, create and update customers and organizations, read mailboxes, folders and saved replies, and pull volume, productivity and happiness reports. It can also start a new conversation in a mailbox.

Can the AI send replies without me seeing them first?

It can send replies, and they are emailed to the customer. It can also save a reply as a draft, so you review and send it in Help Scout. In HeyMyApps you can require approval for replies, or switch the reply tool off and use notes only.

Does the AI see my Help Scout API key?

No. Your App ID and App Secret is encrypted at rest and never shown to the AI. Once saved, it is not shown again, not even to you. The AI only works through the tools you switch on.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on. Risky actions, such as sending a reply to a customer, can require your approval before they run. Every tool call is logged, so you can see what the AI did.

Does it work with ChatGPT?

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

What does it cost?

Help Scout connects with OAuth, and OAuth connections need the HeyMyApps Pro plan or above. HeyMyApps also has a free plan with no credit card, but it does not include this connection. Paid plans bill per completed task.