# Help Scout MCP connector

The Help Scout connector brings your customers, conversations, replies, notes, attachments, tags and team members to Claude, ChatGPT, Cursor and other MCP clients, so each person works their queue in plain language inside their own Help Scout access.

Source: https://elaichi.ai/connectors/helpscout/

## Facts

| | |
| --- | --- |
| Application | Help Scout |
| Category | Helpdesk |
| AI tools | 90 |
| Authentication | Connects over OAuth |
| Needs your own OAuth app | Yes |
| MCP endpoint | https://api.elaichi.ai/mcp |
| Works with | Claude, ChatGPT, Cursor, any MCP client, and the Elaichi Agent |
| Tools advertised by name | No. 90 tools is past the 30-tool threshold, so clients use `search_tools` and `execute_tool` |

## What you can ask once Help Scout is connected

- Summarize open Help Scout conversations assigned to me today.
- Which customers have more than three unresolved conversations?
- List Help Scout users with conversations waiting over 24 hours.

## Connect Help Scout in Elaichi

This happens once for the organization, before any client is involved.

1. Open Connections, choose Add connection, and pick Help Scout.
2. Optionally set Share with, then press Connect.
3. Supply your own Help Scout app, then approve. Help Scout needs an OAuth app you register yourself, so bring its client ID and secret. One person does this once for the organization.

Credentials are vaulted and nobody, including the AI, reads them back. The connection becomes a toolbox immediately, so you can curate which Help Scout tools are exposed, rename them, or freeze arguments before anyone points a client at it.

## Connect Help Scout to Claude

Endpoint: https://api.elaichi.ai/mcp

1. Open Customize, then Connectors.
2. Press Add.
3. Name it, paste the MCP server URL, then Continue.
4. Sign in and approve.

On Team and Enterprise, an Owner adds it once. Everyone else turns it on for themselves.

## Connect Help Scout to ChatGPT

Endpoint: https://api.elaichi.ai/mcp

1. Open Plugins, then press the + button.
2. Name it and paste the endpoint into Server URL.
3. Leave Authentication on OAuth, then tick the risk acknowledgement.
4. Press Create, then sign in and approve.

Works on the web today. The plugin directory lives at chatgpt.com/plugins.

## Connect Help Scout to Cursor

Endpoint: https://api.elaichi.ai/mcp

1. Open `~/.cursor/mcp.json`.
2. Add the endpoint under `mcpServers`.
3. Reload Cursor, then sign in and approve.

Set up per machine, so repeat it on each computer you work from.

## Connect Help Scout to any MCP client

Endpoint: https://api.elaichi.ai/mcp

1. Add the endpoint as a remote MCP server.
2. Sign in and approve.

The Elaichi Agent already has these tools, with nothing to set up.

## What the consent screen decides

Only Read is granted by default, which is not enough to call a Help Scout tool. Over MCP there is no trusted place to confirm a write in the moment, so the consent screen is the standing approval rather than a formality. Grant Read and Run tools. Think hard before granting Delete, which reaches into connected apps and cannot be undone.

## What teams do with Help Scout through Elaichi

### Catch up on a customer before replying

Support. Ask for everything Help Scout has on a customer, including their open and recent conversations, and read the thread history before you answer.

### Draft a reply or leave a note

Support. Have a reply drafted from the conversation so far, or add an internal note on the thread for the next agent who picks it up.

### Find what is piling up in the queue

Support leads. List active conversations by tag, mailbox or assignee and see where the backlog is before the morning standup.

### Open a conversation on a customer's behalf

Success. Start a new Help Scout conversation after a call, attach the file the customer sent, and get it into the right mailbox without switching windows.

### Check a prospect's support history

Sales. Before a renewal or upsell call, pull the account's recent Help Scout conversations and see what they have been asking about.

### Keep customer records clean

Operations. Create a Help Scout customer for a new account, fix a wrong email or company name, and merge duplicates when they show up.

## Frequently asked questions

### How do I connect Help Scout to Claude?

First, register an OAuth application inside Help Scout under your profile's My Apps page and copy its client ID and secret into Elaichi once, when you add the Help Scout connector. Elaichi then sends you to Help Scout's own sign-in screen, where you approve access as yourself. Second, in Claude open Customize, then Connectors, then Add, and paste https://api.elaichi.ai/mcp as the address. Nobody else on your team has to touch the client ID or secret again.

### Does Help Scout work with ChatGPT and Cursor as well as Claude?

Yes. Once Help Scout is connected in Elaichi, the same endpoint, https://api.elaichi.ai/mcp, works in Claude, ChatGPT, Cursor, any other MCP client and the Elaichi Agent. You connect Help Scout once and every client you use picks it up.

### What can an AI agent actually do with my Help Scout data?

With Help Scout connected, an agent can look up a customer, read their conversations and the replies and notes on each one, draft a reply or add a note, open a new conversation, and download or attach files. It can also list your mailbox users, teams and tags so it can sort and filter the queue the way you would. Short, concrete asks work best, such as "find open conversations tagged billing" rather than a long paragraph.

### Does connecting Help Scout give the AI every mailbox?

No. Every request runs as the person who signed in to Help Scout, so the agent only sees the mailboxes, conversations and customers that person can already open in Help Scout. Elaichi can narrow that further with restrictions, but it can never grant access the person does not already have.

### Can my team share one Help Scout connection?

Yes. One person connects Help Scout in Elaichi and shares the connection with a team, and nobody else ever handles the client ID, secret or a password. Each teammate still signs in to Elaichi as themselves, so the audit log names the actual person behind every reply, note and customer change.

### Can I stop an agent from deleting or changing things in Help Scout?

Yes. Restrictions in Elaichi apply per action, so you can allow reading Help Scout conversations and customers while blocking deletes, edits, or sending replies. A blocked action is never shown to Claude, ChatGPT, Cursor or any other client, so no prompt, however worded, can reach it.

### What happens to a Help Scout connection when someone leaves?

When you offboard someone in Elaichi, their access to Help Scout through every connected client ends immediately. If they had shared a Help Scout connection with a team, it keeps working for everyone else. Disconnecting Help Scout once in Elaichi removes it from Claude, ChatGPT, Cursor and every other client at the same time.

## All 90 Help Scout tools

Every tool below is callable through https://api.elaichi.ai/mcp once Help Scout is connected, subject to the toolbox it is in and the restrictions on the caller.

- **List all Help Scout customers** (List). List customers filtered by mailbox, firstName, lastName, or modifiedSince in Help Scout. Returns id, firstName, lastName, gender, jobTitle, location, organization, photoType, photoUrl, age, createdAt, updatedAt, background, and draft fields.
- **Get single Help Scout customer by ID** (Get). Get customer details by id in Help Scout. Returns fields including firstName, lastName, jobTitle, location, organization, photoUrl, background, gender, age, createdAt, updatedAt, draft, and embedded sub-entities like emails, phones, chats, social_profiles, websites, properties, and address.
- **Create a Help Scout customer** (Create). Create a new customer in Help Scout with provided customer details. Returns the resource ID and location of the created customer.
- **Delete a Help Scout customer by ID** (Delete). Delete a customer by id in Help Scout, including their survey responses and conversations. This operation hard-deletes the customer and cannot be undone. Fails if user lacks access to all conversations or if customer has more than 100 conversations.
- **Update a Help Scout customer by ID** (Update). Update a customer profile by id in Help Scout using patch operations on fields such as firstName, lastName, emails, phones, and social profiles. Returns no content on success.
- **Help Scout customers overwrite** (Action). Overwrite customer data by id in Help Scout. Updates fields like firstName, lastName, photoUrl, photoType, jobTitle, location, background, age, gender, and organization. Fields not set will be overwritten with null.
- **List all Help Scout conversations** (List). List conversations filtered by mailbox, folder, status, tag, assigned_to, modifiedSince, number, and customFieldsByIds in Help Scout. Returns id, number, threads, type, folderId, status, subject, mailboxId, assignee, createdBy, createdAt, closedBy, closedAt, tags, cc, bcc, primaryCustomer, snooze, nextEvent, and customFields fields.
- **Get single Help Scout conversation by ID** (Get). Get conversation by id in Help Scout. Returns id, number, threads count, type, folderId, status, state, subject, preview, mailboxId, assignee info, creator info, timestamps, source, tags, cc, bcc, primary customer, custom fields, snooze and next event details.
- **Create a Help Scout conversation** (Create). Create a conversation in Help Scout with required parameters subject, type, mailboxId, status, customer, and threads. Returns the created conversation's ID and location.
- **Update a Help Scout conversation by ID** (Update). Update a conversation in Help Scout by changing subject, customer, draft status, mailbox, status, or owner using id. Returns no content on success. If conversation merged, returns 404.
- **Delete a Help Scout conversation by ID** (Delete). Delete a conversation by id in Help Scout. Returns no content on success. If the conversation was merged, a 404 is returned; use Get Conversation to find the new location.
- **List all Help Scout users** (List). List users in Help Scout. Returns an array of user objects including id, firstName, lastName, email, role, timezone, photoUrl, createdAt, updatedAt, type, mention, initials, jobTitle, phone, and alternateEmails.
- **Get single Help Scout user by ID** (Get). Get information about a specific user in Help Scout by id. Returns id, firstName, lastName, email, role, timezone, type, photoUrl, initials, mention, jobTitle, phone, alternateEmails, createdAt, and updatedAt.
- **Delete a Help Scout user by ID** (Delete). Delete a user by id in Help Scout. Only Administrators and Account Owners can delete users. The user making the request cannot delete themselves.
- **List all Help Scout teams** (List). List teams in Help Scout. Returns an array of teams with fields id, name, initials, mention, createdAt, updatedAt, timezone, and photoUrl.
- **List all Help Scout team members** (List). List team members for team with id in Help Scout. Returns an array of user objects including id, firstName, lastName, email, role, timezone, photoUrl, createdAt, updatedAt, type, mention, initials, jobTitle, phone, and alternateEmails.
- **List all Help Scout tags** (List). List tags used across all inboxes in Help Scout. Returns id, name, slug, ticketCount, color, createdAt, and updatedAt for each tag.
- **Get single Help Scout tag by ID** (Get). Get a tag by id in Help Scout. Returns id, name, slug, and color of the tag.
- **List all Help Scout conversation threads** (List). List threads for a conversation in Help Scout using id. Returns thread id, type, status, state, body, source type and via, customer info, creator info, assigned user, savedReplyId, email fields (to, cc, bcc), createdAt, openedAt, rating, schedule details, and attachments.
- **Create a Help Scout conversation thread** (Create). Create a reply thread for a conversation in Help Scout with required parameters id, text, and customer. Returns the internal ID of the newly created thread in Resource-Id header. Note: max 100 threads per conversation and company policies may restrict updates on old conversations.
- **Update a Help Scout conversation thread by ID** (Update). Update a thread's text or hidden status in Help Scout. Requires id for conversation and thread. Returns no content. Only allowed for administrators or if thread editing is enabled. Supports replace operation on /text and /hidden paths.
- **List all Help Scout conversation attachments** (List). List threads for a conversation in Help Scout using id. Returns thread id, type, status, state, body, source type and via, customer info, createdBy info, assignedTo info, savedReplyId, email fields (to, cc, bcc), createdAt, openedAt, rating details, scheduled details, and attachments.
- **Help Scout conversation attachments download** (Download). Use this endpoint to download the file associated with an attachment in a conversation thread. The URL is provided in the attachments downloadUrl field when you retrieve the conversation threads
- **Create a Help Scout conversation attachment** (Create). Upload an attachment to a specific thread in a conversation in Help Scout. Requires conversation_id, thread_id, fileName, mimeType, and base64-encoded data. The response confirms creation. Uploaded attachments are scanned for malicious content and may be inaccessible if detected.
- **List all Help Scout mailboxes** (List). List mailboxes in Help Scout. Returns id, name, slug, email, createdAt, and updatedAt for each mailbox.
- **Get single Help Scout mailbox by ID** (Get). Get mailbox information by id in Help Scout. Returns id, name, slug, email, createdAt, and updatedAt fields.
- **List all Help Scout me** (List). Get information about the authenticated user in Help Scout. Returns id, firstName, lastName, email, role, timezone, photoUrl, createdAt, updatedAt, type, mention, initials, jobTitle, phone, alternateEmails, and companyId.
- **List all Help Scout mailbox fields** (List). List custom fields for a mailbox in Help Scout using mailbox id. Returns fields with id, required status, order, type, name, and dropdown options with id, order, and label.
- **List all Help Scout customer properties** (List). List customer property definitions in Help Scout. Returns type, slug, name, and options for dropdown properties.
- **Create a Help Scout customer property** (Create). Create a customer property in Help Scout with type, slug, and name. Returns the created property. Limit of 50 customer property definitions per company.
- **Delete a Help Scout customer property by ID** (Delete). Delete a specific customer property definition in Help Scout using id. This is a soft delete operation; the property will be scheduled for hard deletion and its slug released.
- **List all Help Scout inbox folders** (List). List inbox folders for mailbox_id in Help Scout. Returns id, type, name, totalCount, userId, activeCount, and updatedAt for each folder.
- **List all Help Scout ticket fields** (List). Use this endpoint to retrieve all custom field values associated with a specific conversation (ticket) in Help Scout. Custom fields help capture additional information about a conversation, such as priority, order number, or any custom data you’ve configured for your workspace.
- **List all Help Scout inbox saved replies** (List). List saved replies for inbox_id in Help Scout. Returns id, name, preview for email replies, and chatPreview for chats.
- **Get single Help Scout inbox saved reply by ID** (Get). Get a saved reply by inbox_id and id in Help Scout. Returns id, name, text, and chatText of the saved reply.
- **Create a Help Scout inbox saved reply** (Create). Create a saved reply in Help Scout for mailbox_id with required name. Returns the created saved reply including its name, text, and chatText fields.
- **Update a Help Scout inbox saved reply by ID** (Update). Update a saved reply in Help Scout using mailbox_id and id. Returns no content on success.
- **Delete a Help Scout inbox saved reply by ID** (Delete). Delete saved reply by id in Help Scout. Requires mailbox_id and id. No content is returned in the response.
- **List all Help Scout workflows** (List). List workflows filtered by mailboxId and type in Help Scout. Returns id, mailboxId, type, status, order, name, createdAt, and modifiedAt for each workflow.
- **Update a Help Scout workflow by ID** (Update). Update workflow status by setting status to 'active' or 'inactive' in Help Scout. Requires id, op as 'replace', value as new status, and path as '/status'. Returns no content on success.
- **Help Scout workflows run** (Run). Run a specific manual workflow in Help Scout using its workflow_id. Requires workflow_id. Applies workflow actions to each conversation listed in conversationIds (max 50). Returns no content on successful execution.
- **List all Help Scout webhooks** (List). List webhooks in Help Scout. Returns an array of webhooks with fields including id, url, state, events, notification, payloadVersion, and label.
- **Get single Help Scout webhook by ID** (Get). Get information about a specific webhook in Help Scout by id. Returns id, url called on events, list of events, notification flag, label, payloadVersion, and state.
- **Create a Help Scout webhook** (Create). Create a webhook in Help Scout with url, events, and secret. Returns the webhook id in the Resource-ID header.
- **Update a Help Scout webhook by ID** (Update). Update webhook with id in Help Scout. Requires url, events, and secret. Returns no content on success.
- **Delete a Help Scout webhook by ID** (Delete). Delete a webhook by id in Help Scout. Returns no content on success.
- **Get single Help Scout satisfaction rating by ID** (Get). Get satisfaction rating by id in Help Scout. Returns id, threadId, conversationId, conversationNumber, mailboxId, comments, rating, createdAt, user, and customer details.
- **List all Help Scout mailbox folders** (List). List inbox folders for mailbox_id in Help Scout. Returns id, type, name, totalCount, userId, activeCount, and updatedAt for each folder.
- **Get single Help Scout customer address by ID** (Get). Get the address of a specific customer in Help Scout by customer id. Returns city, state, postalCode, country, and address lines.
- **Create a Help Scout customer address** (Create). Create an address for a customer in Help Scout. Requires id, city, state, postalCode, and country. Returns location of the created address.
- **Update a Help Scout customer address by ID** (Update). Update address for a customer in Help Scout using id. Requires city, state, postalCode, and country. Returns no content on success.
- **Delete a Help Scout customer address by ID** (Delete). Delete address for a specific customer in Help Scout. Requires id. No content is returned in the response.
- **List all Help Scout customer chat handles** (List). List chat handles for a customer in Help Scout. Requires customer_id. Returns an array of chat objects with id, value, and type fields.
- **Create a Help Scout customer chat handle** (Create). Create a chat handle for a customer in Help Scout. Requires customer_id, type, and value. Returns the internal ID of the newly created chat handle.
- **Update a Help Scout customer chat handle by ID** (Update). Update chat handle for a specific chat identified by id and customer_id in Help Scout. Requires type (chat type) and value (chat handle). No content is returned in the response.
- **Delete a Help Scout customer chat handle by ID** (Delete). Delete a chat handle for a customer in Help Scout using customer_id and id. No content is returned in the response.
- **List all Help Scout customer emails** (List). List emails for a specific customer in Help Scout. Requires customer_id. Returns an array of email objects including id, value, and type.
- **Create a Help Scout customer email** (Create). Create an email for a customer in Help Scout. Requires customer_id, type (home, other, work), and value (email). Returns Resource-Id header with the internal ID of the new email.
- **Update a Help Scout customer email by ID** (Update). Update email for customer with customer_id and id in Help Scout. Returns no content on success.
- **Delete a Help Scout customer email by ID** (Delete). Delete an email for a specific customer in Help Scout using customer id and email id. No content is returned in the response.
- **List all Help Scout customer phones** (List). List phone numbers for a customer in Help Scout using customer_id. Returns an array of phones with id, value, and type fields.
- **Create a Help Scout customer phone** (Create). Create a phone for customer with customer_id in Help Scout. Requires type and value. Returns the internal ID of the newly created phone in Resource-Id header.
- **Update a Help Scout customer phone by ID** (Update). Update phone for customer using customer_id and id. Requires type (phone location) and value (telephone number). Response returns no content.
- **Delete a Help Scout customer phone by ID** (Delete). Delete a phone by id for a customer in Help Scout. Requires customer_id and id. Returns no content on success.
- **List all Help Scout customer social profiles** (List). List social profiles for a customer in Help Scout. Requires customer_id. Returns id, value (profile URL), and type of each social profile.
- **Create a Help Scout customer social profile** (Create). Create a social profile for a customer in Help Scout using customer_id. Requires type and value. Returns the internal ID of the newly created social profile.
- **Update a Help Scout customer social profile by ID** (Update). Update social profile for customer with customer_id and social profile id in Help Scout. Requires type and value fields. No content is returned in the response.
- **Delete a Help Scout customer social profile by ID** (Delete). Delete a social profile by id for a customer identified by customer_id in Help Scout. No content is returned in the response.
- **List all Help Scout customer websites** (List). List websites for a customer in Help Scout. Requires customer_id. Returns an array of website objects with id and value fields.
- **Create a Help Scout customer website** (Create). Create a website for a customer in Help Scout using customer_id and value. Returns the internal ID of the newly created website in Resource-Id header.
- **Update a Help Scout customer website by ID** (Update). Update website URL for a specific website of a customer in Help Scout. Requires customer_id, id, and value (website URL). Returns no content on success.
- **Delete a Help Scout customer website by ID** (Delete). Delete a specific website by id for a customer identified by customer_id in Help Scout. No content is returned in the response.
- **List all Help Scout user statuses** (List). List user statuses in Help Scout. Returns userId, email (status, updatedAt, performedBy, source), and chat (status, mailboxStatuses) fields for each user.
- **Get single Help Scout user status by ID** (Get). Get the status of a specific user in Help Scout by id. Returns userId, email status details (status, updatedAt, performedBy, source), and chat status details (status and mailboxStatuses).
- **Update a Help Scout user status by ID** (Update). Update user status in Help Scout. Requires id and status. Returns no content on success.
- **List all Help Scout organizations** (List). List organizations in Help Scout. Returns id, name, website, description, location, logoUrl, note, domains, phones, and brandColor for each organization in the response.
- **Get single Help Scout organization by ID** (Get). Get details of a specific organization in Help Scout using id. Returns fields including id, name, website, description, location, brandColor, customerCount, conversationCount, and properties.
- **Create a Help Scout organization** (Create). Create an organization in Help Scout. Returns the id of the created organization in the Resource-ID header, which uniquely identifies the organization.
- **Update a Help Scout organization by ID** (Update). Update an organization in Help Scout using id. Performs a full replacement—any omitted fields are cleared. Returns no content on success.
- **Delete a Help Scout organization by ID** (Delete). Delete a specific organization in Help Scout using id. Also removes this organization reference from all customers. Returns no content on success.
- **List all Help Scout organization conversations** (List). List conversations for an organization in Help Scout. Requires organization_id. Returns conversation details such as id, subject, status, type, assignee, createdAt, and primaryCustomer information.
- **List all Help Scout organization customers** (List). List customers associated with a specific organization in Help Scout. Requires organization_id. Returns id, firstName, lastName, jobTitle, location, organization, photoUrl, createdAt, and updatedAt for each customer.
- **List all Help Scout organization property definitions** (List). List all organization-property-definitions in Help Scout. Each account can have up to 50 property definitions. Returns slug, name, type, and options for dropdown properties.
- **Get single Help Scout organization property definition by ID** (Get). Get an organization property definition in Help Scout using id. Returns slug, name, type, and options array with dropdown labels for the property.
- **Create a Help Scout organization property definition** (Create). Create a new organization property definition in Help Scout. Requires type, slug, and name. Returns the created property's details including type, slug, name, and options for dropdown types.
- **Update a Help Scout organization property definition by ID** (Update). Update an existing organization property definition in Help Scout. Requires id. You can update the property's name and options list. The response returns no content (HTTP 204) on success.
- **Delete a Help Scout organization property definition by ID** (Delete). Delete an organization property definition in Help Scout using id. This performs a soft-delete and the property will be permanently removed after a grace period.
- **List all Help Scout company reports** (List). Get overall company performance report in Help Scout. Returns filterTags (available tag filters), current and previous time range statistics, user performance metrics, and deltas showing performance change when two time ranges are specified.
- **List all Help Scout customer helped reports** (List). Get the customers helped report in Help Scout for a given time range. Returns current and optionally previous arrays including 'date' and 'customers' fields showing how many customers were helped during each period.
- **List all Help Scout company drilldown reports** (List). Get detailed conversation data for a company in Help Scout using required parameters start and end. Returns conversation fields including id, number, type, subject, status, customerName, and assignedName.