Connect your AI to Help Scout

What your AI can do with Help Scout

Once connected, these tools appear automatically in your AI assistant:

• list_mailboxesread-only

  List the mailboxes of the account.

• list_conversationsread-only

  List conversations, optionally filtered by mailbox and status.

• get_conversationread-only

  Get a conversation with its threads (messages).

• list_conversation_threadsread-only

  List a conversation's threads on their own, paginated — what the customer wrote, what each agent replied, and the internal notes. Use this rather than get_conversation when a long exchange needs reading past its first page.

• search_conversationsread-only

  Search conversations by their content, subject, customer or tag, using Help Scout's own query syntax — for example `subject:"remboursement"` or `tag:urgent`. Narrower than listing a mailbox and reading through it.

• add_notewrite · needs approval

  Add an internal note to a conversation. Only the team sees it — nothing reaches the customer. This is the safe way for an assistant to leave a summary or a finding on a ticket.

• reply_to_conversationwrite · needs approval

  Write a reply to the customer. It is created as a DRAFT by default, sitting in Help Scout for a human to read and send — because a published reply is emailed to the customer immediately and cannot be recalled. Pass `draft: false` only when the customer has asked for the reply to go out now. For something only the team should see, use add_note.

• schedule_replywrite · needs approval

  Schedule an existing draft reply to go out at a chosen time. Applies to a draft thread created by reply_to_conversation — take its id from the result. Scheduling again overrides the previous time.

• create_conversationwrite · needs approval

  Open a conversation in a mailbox with a first thread — logging a phone call, recording something a customer said elsewhere. Creating it does not email the customer unless `autoReply` is set. For history brought over from another tool, set `imported` so Help Scout generates no outgoing mail or notification at all.

• update_conversationwrite · needs approval

  Change a conversation's subject, status, owner or mailbox. Assign to a person or a team with `assignTo`, or hand it back to the queue with `unassign`.

• set_conversation_tagswrite · needs approval

  Set the tags of a conversation. THIS REPLACES THE WHOLE SET: every tag missing from the list is removed, and an empty list clears them all. There is no way to add one tag on its own — read the conversation's current tags first with get_conversation, then send them back together with the new one.

• list_customersread-only

  List or search customers, by email, name or the organization they belong to.

• get_customerread-only

  Get one customer's profile, with their emails, phones and organization.

• create_customerwrite · needs approval

  Create a customer profile.

• update_customerwrite · needs approval

  Update a customer's profile fields. Only what you pass is changed; everything else is left alone. Emails and phones are managed on their own and are not touched here.

• get_mailboxread-only

  Get one mailbox, with its sending address and settings.

• list_saved_repliesread-only

  List a mailbox's saved replies — the wording the team has already agreed on. Worth reading before drafting an answer, so a reply matches how the team actually writes.

• list_usersread-only

  List the agents of the account.

• get_userread-only

  Get one agent by id.

• get_current_userread-only

  Get the agent the connection belongs to — who Help Scout thinks is acting. Worth knowing before assigning or signing anything.

• list_teamsread-only

  List the teams of the account. A team can own a conversation, like an agent can.

• list_team_membersread-only

  List the agents belonging to a team.

• list_tagsread-only

  List the tags of the account. Read this before set_conversation_tags, so an existing tag is reused rather than a near-duplicate created.

• get_tagread-only

  Get one tag by id.

• list_organizationsread-only

  List the organizations — the companies customers are grouped under, with their domains, website and notes.

• get_organizationread-only

  Get one organization by id.

• get_ratingread-only

  Get one satisfaction rating: the score (great, okay, not_good), the customer's comment, the agent whose reply was rated, and the conversation it belongs to. The id is the rating's own, not the conversation's.

Example prompts

Just ask your AI in plain language — it picks the right Help Scout tool:

• “List the mailboxes of the account — from Help Scout, in plain language.”
• “List conversations, optionally filtered by mailbox and status — from Help Scout, in plain language.”
• “Get a conversation with its threads (messages) — from Help Scout, in plain language.”
• “List a conversation's threads on their own, paginated — what the customer wrote, what each agent replied, and the internal notes. Use this rather than get_conversation when a long exchange needs reading past its first page — from Help Scout, in plain language.”

How it works

1. Create your Proxoria account and add your MCP endpoint to Claude or ChatGPT.
2. Connect Help Scout with your API key — each user connects their own account, credentials encrypted at rest.
3. Your AI instantly gets the Help Scout tools. Write actions wait for your approval in the dashboard before anything changes.

Frequently asked questions

Does Help Scout have an official MCP server?

You don't need one. Proxoria exposes Help Scout to your AI through the Model Context Protocol, so you can use it from Claude, ChatGPT, Mistral or any MCP-compatible client — no official Help Scout MCP server required.

What can my AI do with Help Scout through Proxoria?

It gets 27 tools: list_mailboxes, list_conversations, get_conversation, list_conversation_threads, search_conversations, add_note, reply_to_conversation, schedule_reply, create_conversation, update_conversation, set_conversation_tags, list_customers, get_customer, create_customer, update_customer, get_mailbox, list_saved_replies, list_users, get_user, get_current_user, list_teams, list_team_members, list_tags, get_tag, list_organizations, get_organization, get_rating. For example, list the mailboxes of the account.

Is the Help Scout connector read-only?

No — it can also make changes. Write actions go through Proxoria's confirmation guardrail by default: your AI proposes them, and you approve each one from your dashboard before anything is written to Help Scout.

How do I connect Help Scout to my AI?

Create a Proxoria account, connect Help Scout with your API key, and add your Proxoria MCP endpoint to Claude or ChatGPT. Your AI instantly gains the Help Scout tools.