Customer Relation

Help Scout MCP Server

Connect your account, then chat with AI to run tools.

Triage Help Scout conversations, inspect customer profiles, and draft replies from chat — grounded in your shared inbox, teams, and tags.

Best forCustomer SupportCustomer Success ManagersOperations LeadsSmall Business Owners

Try this workflow

Morning inbox triage

Show my open Help Scout conversations sorted by oldest customer wait, summarize each subject and assignee, and flag anything pending over 24 hours.

Managed
12 tools
Agent guide included

Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.

Browse all tools

What you can do with Help Scout

Built for

Customer Support Teams, Customer Success Managers, Operations Leads, Small Business Owners

Example workflows

Morning inbox triage

Turns live queue data into a prioritized stand-up brief.

Try this

Show my open Help Scout conversations sorted by oldest customer wait, summarize each subject and assignee, and flag anything pending over 24 hours.

Customer context before reply

Grounds a reply in profile + thread history instead of guessing.

Try this

For the Help Scout conversation about billing from yesterday, pull the customer profile, list prior tickets, and summarize what was already answered.

Team workload snapshot

Connects roster data to live assignment load.

Try this

List Help Scout teams, show member counts per team, and count active conversations assigned to each agent right now.

Draft a follow-up reply

Exercises reply creation with an explicit human send gate.

Try this

Draft a Help Scout reply confirming the refund was processed, set it as a draft first, and show me the conversation id before sending.

Context to know first

What can AI agents do with Help Scout?

Agents can list or fetch conversations, customers, inboxes, tags, teams, users, and workflows. They can create or update conversations and customers, post replies or drafts, and delete rows when explicitly asked.

How does Help Scout authentication work on MCPBundles?

Sign in to MCPBundles and connect Help Scout once in your browser. OAuth keeps the access token fresh server-side until you disconnect.

Can agents send email replies automatically?

Agents can create draft replies or published replies when you ask. Use draft mode when you want to review in Help Scout before customers receive mail.

AI Skill
SKILL.md

Domain knowledge for Help Scout — workflow patterns, data models, and gotchas for your AI agent.

Help Scout

Help Scout is a shared-inbox customer support platform (email, chat, phone). Conversations are tickets; customers carry contact profiles; inboxes (mailboxes) scope routing and custom fields.

Hierarchy

  • Inbox — mailbox that receives conversations; capture inbox id before nested field or folder reads.
  • Conversation — support ticket with subject, status, assignee, tags, and a thread timeline.
  • Customer — profile linked to conversations; match by id or email on creates.
  • Team / User — roster data for assignment and workload context.
  • Workflow — automation definitions (list before manual runs).
  • Tag — account-wide labels for filtering and reporting.

Operational order

  1. List inboxes to resolve mailbox ids for new conversations or inbox-scoped metadata.
  2. List or search conversations before fetching threads — always take conversation ids from a fresh list response.
  3. List customers when you need profile context or before linking a ticket to a known contact.
  4. List teams and users when assigning or summarizing ownership.
  5. Prefer combined read tools: omit id to list, pass id to fetch one row; pass team id to load members; pass inbox id with sub_resource for fields or folders.

Write semantics

  • Conversation create — POST with subject, mailbox id, channel type, customer object, and at least one thread.
  • Conversation update — PATCH JSON Patch operations (/subject, /status, /assignTo, /mailboxId, /primaryCustomer.id).
  • Reply — POST reply on an existing conversation id with customer object and text (draft flag optional).
  • Customer create — POST profile fields; customer update — PATCH JSON Patch array.
  • Deletes — conversation and customer DELETE are permanent; customer delete is GDPR erasure and may fail when conversation count exceeds upstream limits.

Gotchas

  • Stale conversation ids: Merged or deleted tickets return not-found on thread reads — re-list conversations and use a current id.
  • JSON Patch updates: Conversation and customer updates require a patch operation array, not a flat body.
  • Rate limits: Help Scout enforces per-account request quotas; pace bulk reads and writes.
  • Merged conversations: Old ids may 301 to a new location for 60 days, then 404 — fetch the conversation row to resolve the canonical id before mutating.

Tools in this Server (12)

Help Scout Delete Conversation

Permanently delete a Help Scout conversation by id. Merged conversations return not-found on the old id — resolve the current id with a single-row fet...

Help Scout Delete Customer

Permanently delete a Help Scout customer and their conversations (GDPR erasure). Fails with forbidden when the customer has more than 100 conversation...

Help Scout Get Conversations

List or fetch Help Scout support conversations (email, chat, phone). Omit id to list with optional status, mailbox, query, sort, and page filters. Pas...

Help Scout Get Customers

List or fetch Help Scout customer profiles with contact details and custom properties. Omit id to list with optional query search, sort, and page. Pas...

Help Scout Get Inboxes

List Help Scout inboxes (mailboxes) or read inbox-scoped metadata. Omit id to list every inbox. Pass inbox id with sub_resource fields to list custom ...

Help Scout Get Tags

List every conversation tag defined in the connected Help Scout account. Tags are account-wide labels used for filtering and reporting.

Help Scout Get Teams

List Help Scout teams (omit id) or list members for one team (pass id). Optional page paginates HAL responses. Parameter id is the Help Scout team id ...

Help Scout Get Users

List Help Scout account users or fetch one profile. Omit id to list every user. Pass me as id to load the authenticated agent profile, or pass a numer...

Help Scout Get Workflows

List automated workflows configured in Help Scout. Workflows drive routing, tagging, and status changes — use ids from this list before invoking manua...

Help Scout Reply To Conversation

Add an agent reply, note, or draft thread to an existing conversation. Requires conversation id, customer object, and text. Set draft true to save wit...

Help Scout Upsert Conversation

Create or update a Help Scout conversation. Omit id to POST a new ticket — requires subject, mailbox_id, type (email, chat, or phone), customer object...

Help Scout Upsert Customer

Create or update a Help Scout customer profile. Omit id to POST a new customer (first_name, last_name, emails, phones, and other profile fields). Pass...

Frequently Asked Questions

What can AI agents do with Help Scout?

Agents can list or fetch conversations, customers, inboxes, tags, teams, users, and workflows. They can create or update conversations and customers, post replies or drafts, and delete rows when explicitly asked.

How does Help Scout authentication work on MCPBundles?

Sign in to MCPBundles and connect Help Scout once in your browser. OAuth keeps the access token fresh server-side until you disconnect.

Can agents send email replies automatically?

Agents can create draft replies or published replies when you ask. Use draft mode when you want to review in Help Scout before customers receive mail.

Why do thread reads sometimes fail?

Conversation ids go stale after merges or deletes. Re-list conversations and use an id from the latest response before loading threads or posting replies.

How do I connect Help Scout to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/help-scout. Authentication is handled automatically.

How many tools does Help Scout provide?

Help Scout provides 12 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does Help Scout require?

Help Scout uses One-click sign in. Help Scout requires credentials. Connect via MCPBundles and authentication is handled automatically.

Setup Instructions

Connect Help Scout to any MCP client in minutes

MCP URL
https://mcp.mcpbundles.com/bundle/help-scout

One-click install:

The link prefills the Add custom connector dialog — you still review the values and click Add, then Connect to complete OAuth.

Or add manually

  1. Open claude.ai → Settings → Connectors.
  2. Click the + button and choose Add custom connector.
  3. Set Name to Help Scout and paste the MCP URL into Remote MCP server URL.
  4. Click Add. Help Scout will appear under Not connected — select it and click Connect to complete OAuth.
Name: Help Scout
Remote MCP server URL: https://mcp.mcpbundles.com/bundle/help-scout
Authentication: OAuth

Custom connectors at claude.ai require a paid Claude plan (Pro, Max, Team, or Enterprise).

Ready to use Help Scout?

Sign in to connect your credentials and start running tools from the chat.

Help Scout MCP Server — Shared Inbox Support for AI Agents