The Help Scout MCP connector routes your AI agent's tool calls to Help Scout's own MCP server through Scalekit. Each user signs in to Help Scout once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 54 tools.
- Tools
- 54
- What they doRead · write · destructive
- 54 · 0 · 054 read0 write0 destructive
- Users sign in with
- OAuth
- OAuth app
- Your own Help Scout MCP server app
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Help Scout MCP connection
In AgentKit > Connections, create a Help Scout MCP connection and copy its redirect URI. The name you give it is the
connection_nameyour code passes. See Configure connections.Register an OAuth app
Help Scout MCP server connections use your own OAuth app. Register one with Help Scout MCP server and add the redirect URI you copied.
Then enter the app's Client ID and Client Secret on the Help Scout MCP connection.
Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'helpscoutmcp'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Help Scout MCP:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'helpscoutmcp_get_me',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "helpscoutmcp"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Help Scout MCP:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="helpscoutmcp_get_me",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user signs in once. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolhelpscoutmcp_docs_get_articleGet a single Docs article by ID (Requires linked Docs API key)Read-onlyGet Docs Article
Get a single Docs article by ID (Requires linked Docs API key)
Inputs
articleIdstringrequired- Article ID
draftboolean- Get draft version if true
helpscoutmcp_docs_get_siteGet a Docs site by ID (Requires linked Docs API key)Read-onlyGet Docs Site
Get a Docs site by ID (Requires linked Docs API key)
Inputs
siteIdstringrequired- Site ID
helpscoutmcp_docs_list_articlesList articles in a collection or in one category.Read-onlyList Docs Articles
List articles in a collection or in one category. Pass exactly one of collectionId or categoryId; use docs_list_categories to find a category ID. status: "notpublished" returns articles that aren't live, including ones that were published before. A live article with unpublished edits has status "published" and hasDraft: true. Results are paginated. Pass page=1 (default) to start; check the response for total pages and request subsequent pages as needed. (Requires linked Docs API key)
Inputs
categoryIdstring- Category ID
collectionIdstring- Collection ID
orderstring- No description.one of
ascdesc pagenumber- No description.
pageSizeinteger- Articles per page, up to 100. Defaults to 50.
sortstring- No description.one of
numberstatusnamepopularitycreatedAtupdatedAt statusstring- No description.one of
allpublishednotpublished
helpscoutmcp_docs_list_categoriesList the categories in a Docs collection.Read-onlyList Docs Categories
List the categories in a Docs collection. Pass a category ID to docs_list_articles to list only that category's articles. Results are paginated. Pass page=1 (default) to start; check the response for total pages and request subsequent pages as needed. (Requires linked Docs API key)
Inputs
collectionIdstringrequired- Collection ID
orderstring- No description.one of
ascdesc pagenumber- No description.
sortstring- No description.one of
numberordernamearticleCountcreatedAtupdatedAt
helpscoutmcp_docs_list_collectionsList collections in a Docs site.Read-onlyList Docs Collections
List collections in a Docs site. Results are paginated. Pass page=1 (default) to start; check the response for total pages and request subsequent pages as needed. (Requires linked Docs API key)
Inputs
pagenumber- No description.
siteIdstring- Filter by site ID
visibilitystring- public (customers can see it) or private (admin only). Defaults to all.one of
allpublicprivate
helpscoutmcp_docs_list_sitesList Docs sites.Read-onlyList Docs Sites
List Docs sites. Results are paginated. Pass page=1 (default) to start; check the response for total pages and request subsequent pages as needed. (Requires linked Docs API key)
Inputs
pagenumber- Page number (default 1)
helpscoutmcp_docs_search_articlesSearch Docs articles by query.Read-onlySearch Docs Articles
Search Docs articles by query. Results are paginated. Pass page=1 (default) to start; check the response for total pages and request subsequent pages as needed. An article is visible to customers only if it is published AND its collection is public: status: "published" alone still returns articles in private (admin-only) collections. To find content you can send a customer, pass status: "published" and visibility: "public". (Requires linked Docs API key)
Inputs
querystringrequired- Search query string. Sent to the Help Scout Docs API article search endpoint: https://developer.helpscout.com/docs-api/articles/search/
collectionIdstring- Limit to a collection
pagenumber- No description.
siteIdstring- Limit to a site
statusstring- No description.one of
allpublishednotpublished visibilitystring- Visibility of the article's collection: public (customers can see it) or private (admin only). Defaults to all.one of
allpublicprivate
helpscoutmcp_get_chat_reportGet the Chat report for a date range: live chat volume, wait and response times, and chat length.Read-onlyGet Chat Report
Get the Chat report for a date range: live chat volume, wait and response times, and chat length. In `current`: volume.chatConversations is every chat conversation created in the range, including third-party chat integrations. Every other metric covers Beacon chats only. completedChats and missedChats count Beacon chat sessions, and one conversation can hold more than one, so completedChats + missedChats can be higher or lower than chatConversations. completedChats were accepted and then ended by either side. missedChats were never connected to a user, usually because no one was available, so the question moved to email. chatsPerDay is chatConversations divided by the days in the range. All times are in seconds, and are 0 (not null) when there were no chats. responses.waitTime is the average wait from the visitor starting the chat (or entering their email, when Beacon requires one) to a user accepting or being assigned it. Missed chats are excluded. responses.responseTime is the average time a customer waited for a user reply. Only the first user reply after each customer message counts, and chats with no user reply are excluded. resolutions.duration is the average time from a chat being accepted to it ending. resolutions.messagesPerChat is the average number of messages per chat. The top-level waitTime, responseTime, messagesPerChat and duration objects bucket chats by that metric, as a count and percent per range id. waitTime: 1=under 1 min, 2=1–2 min, 3=2–10 min, 4=10–20 min, 5=20 min or more. responseTime: 1=under 1 min, 2=1–2 min, 3=2–5 min, 4=5–10 min, 5=10 min or more. messagesPerChat: 1=under 5, 2=5–10, 3=10–20, 4=20–30, 5=30 or more. duration: 1=under 5 min, 2=5–10 min, 3=10–20 min, 4=20–30 min, 5=30 min or more. Ranges may not be listed in id order. Pass previousStart and previousEnd to also get `previous` (the same metrics for that range), `deltas` (percentage change per metric), and previousCount and previousPercent on each range. previousPercent is rounded down to a whole number, unlike percent. Without a comparison range, each bucket object's previousCount is 0, not missing. For one user's or team's chat metrics use get_user_chat_report.
Inputs
endstringrequired- End date/time in ISO 8601 format
startstringrequired- Start date/time in ISO 8601 format
foldersstring- Comma-separated folder IDs
mailboxesstring- Comma-separated mailbox IDs
officeHoursboolean- Restrict metrics to office hours only. Ignored unless office hours are set up. Default false.
previousEndstring- End of the prior comparison period (ISO 8601)
previousStartstring- Start of the prior comparison period (ISO 8601)
tagsstring- Comma-separated tag IDs
helpscoutmcp_get_company_drilldownGet the individual conversations behind the Company report for a date range, filtered by one metric dimension.Read-onlyGet Company Drilldown
Get the individual conversations behind the Company report for a date range, filtered by one metric dimension. Returns a paginated conversation list. Results are paginated. Pass page=1 (default) to start; check the response for total pages and request subsequent pages as needed.
Inputs
endstringrequired- End date/time in ISO 8601 format, e.g. 2025-01-31T23:59:59Z
rangestringrequired- Metric dimension to drill into.one of
repliesfirstReplyResolvedresolvedresponseTimefirstResponseTimehandleTime startstringrequired- Start date/time in ISO 8601 format, e.g. 2025-01-01T00:00:00Z
mailboxesstring- Comma-separated mailbox IDs to filter
pagenumber- Page number for pagination
rangeIdnumber- Bucket index within the chosen range. For handleTime: 1=under 1 min, 2=1–2 min, 3=2–5 min, 4=5–10 min, 5=10 min or more. firstReplyResolved and resolved take no rangeId.
rowsinteger- Results per page (default 25, max 50).
tagsstring- Comma-separated tag IDs to filter
typesstring- Filter by conversation type: email, chat, or phone.one of
emailchatphone
helpscoutmcp_get_company_reportGet the overall company report with conversation metrics for a date range.Read-onlyGet Company Report
Get the overall company report with conversation metrics for a date range. The response includes a `users` array with each user's replies and customers helped within the range — use it for "how much did this person do in this period" questions.
Inputs
endstringrequired- End date/time in ISO 8601 format, e.g. 2025-01-31T23:59:59Z
startstringrequired- Start date/time in ISO 8601 format, e.g. 2025-01-01T00:00:00Z
mailboxesstring- Comma-separated mailbox IDs to filter
tagsstring- Comma-separated tag IDs to filter
helpscoutmcp_get_conversationGet a single conversation by ID with full details.Read-onlyGet Conversation
Get a single conversation by ID with full details. With embed: 'threads', the response includes every thread in the conversation, unpaginated, in one call. That can be very large on long conversations; if it is too big, use list_threads to page through them instead. Here, createdBy, assignee and thread authors can have type system_user: an AI agent, not a person. Other tools still report AI agents as type user.
Inputs
conversation_idnumberrequired- The conversation ID
embedstring- Set to 'threads' to include every thread, unpaginatedone of
threads
helpscoutmcp_get_conversation_summaryGet a conversation summary: the customer's first message and the latest reply they received.Read-onlyGet Conversation Summary
Get a conversation summary: the customer's first message and the latest reply they received. Either can be null. Notes, drafts and replies that were never sent are excluded. A logged phone call is an inbound call, not a reply. A Beacon chat is one transcript, so both fields are null. customerMessageIsFirst is false when the oldest threads hold no customer message or could not be read, and customerMessage fell back to the oldest one among the 25 most recent threads; list_threads exposes the rest, one page at a time.
Inputs
conversation_idnumberrequired- The conversation ID
helpscoutmcp_get_conversations_drilldownGet the individual conversations behind the Conversations report for a date range.Read-onlyGet Conversations Drilldown
Get the individual conversations behind the Conversations report for a date range. Returns a paginated conversation list. Results are paginated. Pass page=1 (default) to start; check the response for total pages and request subsequent pages as needed.
Inputs
endstringrequired- End date/time in ISO 8601 format
startstringrequired- Start date/time in ISO 8601 format
foldersstring- Comma-separated folder IDs
mailboxesstring- Comma-separated mailbox IDs
pagenumber- Page number for pagination
rowsinteger- Results per page (default 25, max 50).
tagsstring- Comma-separated tag IDs
typesstring- Filter by conversation type: email, chat, or phone.one of
emailchatphone
helpscoutmcp_get_conversations_fields_drilldownGet the individual conversations behind the Conversations report, drilled down by a single field (tag, saved reply, workflow, or customer).Read-onlyGet Conversations Fields Drilldown
Get the individual conversations behind the Conversations report, drilled down by a single field (tag, saved reply, workflow, or customer). Returns a paginated conversation list. Results are paginated. Pass page=1 (default) to start; check the response for total pages and request subsequent pages as needed.
Inputs
endstringrequired- End date/time in ISO 8601 format
fieldstringrequired- Which field to drill down by.one of
tagidreplyidworkflowidcustomerid fieldidnumberrequired- The ID of the field value chosen in `field` (e.g. the tag ID when field=tagid).
startstringrequired- Start date/time in ISO 8601 format
foldersstring- Comma-separated folder IDs
mailboxesstring- Comma-separated mailbox IDs
pagenumber- Page number for pagination
rowsinteger- Results per page (default 25, max 50).
tagsstring- Comma-separated tag IDs
typesstring- Filter by conversation type: email, chat, or phone.one of
emailchatphone
helpscoutmcp_get_conversations_new_drilldownGet the individual new conversations behind the New Conversations report for a date range.Read-onlyGet Conversations New Drilldown
Get the individual new conversations behind the New Conversations report for a date range. Returns a paginated conversation list. Results are paginated. Pass page=1 (default) to start; check the response for total pages and request subsequent pages as needed.
Inputs
endstringrequired- End date/time in ISO 8601 format
startstringrequired- Start date/time in ISO 8601 format
foldersstring- Comma-separated folder IDs
mailboxesstring- Comma-separated mailbox IDs
pagenumber- Page number for pagination
rowsinteger- Results per page (default 25, max 50).
tagsstring- Comma-separated tag IDs
typesstring- Filter by conversation type: email, chat, or phone.one of
emailchatphone
helpscoutmcp_get_conversations_reportGet the conversations report with volume and trend data for a date range.Read-onlyGet Conversations Report
Get the conversations report with volume and trend data for a date range.
Inputs
endstringrequired- End date/time in ISO 8601 format
startstringrequired- Start date/time in ISO 8601 format
mailboxesstring- Comma-separated mailbox IDs
tagsstring- Comma-separated tag IDs
helpscoutmcp_get_custom_fieldsGet the custom field values set on a specific conversation.Read-onlyGet Custom Fields
Get the custom field values set on a specific conversation.
Inputs
conversation_idnumberrequired- The conversation ID
helpscoutmcp_get_customerGet a single customer by ID with full details including emails, phones, social profiles, etc.Read-onlyGet Customer
Get a single customer by ID with full details including emails, phones, social profiles, etc.
Inputs
customer_idnumberrequired- The customer ID
helpscoutmcp_get_docs_reportGet the Docs (knowledge base) report for a date range: visit metrics, popular and failed searches, and top articles and categories.Read-onlyGet Docs Report
Get the Docs (knowledge base) report for a date range: visit metrics, popular and failed searches, and top articles and categories. In `current`: visitors is the number of visits (sessions). foundAnAnswerResult is the percentage of visits that viewed at least one article and failedResult the percentage that viewed none. Neither tracks whether the visitor went on to contact support. searchAction and browseAction split sessions between searching and viewing an article, as percentages. docsViewedPerVisit is article views per session. answers counts "great" article ratings. conversationsCreated counts conversations created in the range, not contacts that came from Docs. sentAnEmailResult, resolutionRate and timeSaved are always 0 and answerRate is always 100 when there is data: they are no longer calculated, so ignore them. popularSearches and failedSearches are the raw terms visitors typed. They are not merged by case and can include spam. Pass previousStart and previousEnd to also get `previous` (the same metrics for that range), `deltas` (percentage change per metric), and previousCount and deltaPercent on each list item. Use docs_list_sites to find site IDs.
Inputs
endstringrequired- End date/time in ISO 8601 format
startstringrequired- Start date/time in ISO 8601 format
previousEndstring- End of the prior comparison period (ISO 8601)
previousStartstring- Start of the prior comparison period (ISO 8601)
sitesstring- Comma-separated Docs site IDs to filter. Defaults to all sites.
helpscoutmcp_get_happiness_ratingsGet individual satisfaction ratings with customer details.Read-onlyGet Happiness Ratings
Get individual satisfaction ratings with customer details. Supports filtering by rating value (great/ok/not-good) and tag. Useful for drilling into specific segments — e.g. all 'not good' ratings from VIP accounts. Results are paginated. Pass page=1 (default) to start; check the response for total pages and request subsequent pages as needed.
Inputs
endstringrequired- End date/time in ISO 8601 format
startstringrequired- Start date/time in ISO 8601 format
mailboxesstring- Comma-separated mailbox IDs
pagenumber- Page number for pagination
ratingstring- Filter by rating value. Defaults to all.one of
greatoknot-goodall sortFieldstring- Field to sort byone of
numberratingmodifiedAt sortOrderstring- Sort directionone of
ASCDESC tagsstring- Comma-separated tag IDs
helpscoutmcp_get_happiness_reportGet the happiness/satisfaction report with rating data.Read-onlyGet Happiness Report
Get the happiness/satisfaction report with rating data.
Inputs
endstringrequired- End date/time in ISO 8601 format
startstringrequired- Start date/time in ISO 8601 format
mailboxesstring- Comma-separated mailbox IDs
tagsstring- Comma-separated tag IDs
helpscoutmcp_get_inboxGet details of a specific inbox: ID, name, slug, email and timestamps.Read-onlyGet Inbox
Get details of a specific inbox: ID, name, slug, email and timestamps. Folders and custom fields are referenced as links only, not returned as data — use list_inbox_folders and list_inbox_custom_fields for those.
Inputs
mailbox_idnumberrequired- The mailbox/inbox ID
helpscoutmcp_get_meGet the currently authenticated user (resource owner).Read-onlyGet Current User
Get the currently authenticated user (resource owner).
Inputs
This tool takes no inputs.
helpscoutmcp_get_organizationGet details for a specific organization.Read-onlyGet Organization
Get details for a specific organization.
Inputs
organization_idnumberrequired- The organization ID
helpscoutmcp_get_productivity_reportGet the productivity report with response time, resolution time, and replies data.Read-onlyGet Productivity Report
Get the productivity report with response time, resolution time, and replies data. The top-level responseTime, firstResponseTime, resolutionTime, handleTime and repliesToResolve objects bucket by that metric, as a count and percent per range id. responseTime and firstResponseTime: 1=under 15 min, 2=15–30 min, 3=30–60 min, 4=1–2 hours, 5=2–3 hours, 6=3–6 hours, 7=6–12 hours, 8=12–24 hours, 9=1–2 days, 10=2 days or more. resolutionTime: 1=under 4 hours, 2=4 hours–1 day, 3=1–2 days, 4=2–4 days, 5=4 days or more. handleTime: 1=under 1 min, 2=1–2 min, 3=2–5 min, 4=5–10 min, 5=10 min or more. repliesToResolve: the id is the number of replies, and 5 means 5 or more. Ranges may not be listed in id order.
Inputs
endstringrequired- End date/time in ISO 8601 format
startstringrequired- Start date/time in ISO 8601 format
mailboxesstring- Comma-separated mailbox IDs
officeHoursboolean- Restrict metrics to office hours only. Ignored unless office hours are set up. Default false.
tagsstring- Comma-separated tag IDs
helpscoutmcp_get_saved_replyGet a specific saved reply with its full text body.Read-onlyGet Saved Reply
Get a specific saved reply with its full text body.
Inputs
mailbox_idnumberrequired- The mailbox/inbox ID
saved_reply_idnumberrequired- The saved reply ID
helpscoutmcp_get_server_contextGet server configuration and available capabilitiesRead-onlyGet Server Context
Get server configuration and available capabilities
Inputs
This tool takes no inputs.
helpscoutmcp_get_tagGet a specific tag by ID.Read-onlyGet Tag
Get a specific tag by ID.
Inputs
tag_idnumberrequired- The tag ID
helpscoutmcp_get_userGet a specific user by ID.Read-onlyGet User
Get a specific user by ID.
Inputs
user_idnumberrequired- The user ID
helpscoutmcp_get_user_chat_reportGet chat metrics for a single user, or for a whole team when given a team ID, over a date range.Read-onlyGet User Chat Report
Get chat metrics for a single user, or for a whole team when given a team ID, over a date range. Counts only Beacon chats the user (or any team member) took part in. In `current`: newConversations is the number of those chats created in the range, and totalDays the days in the range. waitTime, responseTime and duration are average seconds, measured as in get_chat_report: wait to be accepted, wait for a user reply, and time from acceptance to the chat ending. They are null when there were no chats, unlike get_chat_report, which returns 0. messagesPerChat is the average number of messages per chat. There are no completed or missed chat counts per user: use get_chat_report for those, company-wide. To compare users, call this once per user (list_users gives the IDs). Pass previousStart and previousEnd to also get `previous` and `deltas` (percentage change per metric).
Inputs
endstringrequired- End date/time in ISO 8601 format
startstringrequired- Start date/time in ISO 8601 format
usernumberrequired- Help Scout user ID, or a team ID to get combined metrics for its members.
mailboxesstring- Comma-separated mailbox IDs
officeHoursboolean- Restrict metrics to office hours only. Ignored unless office hours are set up. Default false.
previousEndstring- End of the prior comparison period (ISO 8601)
previousStartstring- Start of the prior comparison period (ISO 8601)
tagsstring- Comma-separated tag IDs
helpscoutmcp_get_user_conversation_historyGet a single user's conversations over a date range with per-conversation metrics (response time, resolve time, replies sent).Read-onlyGet User Conversation History
Get a single user's conversations over a date range with per-conversation metrics (response time, resolve time, replies sent). These metrics cover the whole conversation across its lifetime, including other users' replies, not just this user or this range. Matches conversations this user has touched at any time that were also touched within the date range, not necessarily by this user. A touch is any update: user or customer replies, notes, assignment, status changes, or workflows. This is the intended behaviour of the User report's Total Conversations / Conversation History. It does not show what the user did within the range, and no report lists only the conversations a user worked on in a range. For in-range counts use the `users` array in get_company_report. Returns a paginated list, one row per conversation. Results are paginated. Pass page=1 (default) to start; check the response for total pages and request subsequent pages as needed.
Inputs
endstringrequired- End date/time in ISO 8601 format
startstringrequired- Start date/time in ISO 8601 format
usernumberrequired- Help Scout user ID.
foldersstring- Comma-separated folder IDs
mailboxesstring- Comma-separated mailbox IDs
officeHoursboolean- Restrict metrics to office hours only. Default false.
pagenumber- Page number for pagination
previousEndstring- End of the prior comparison period (ISO 8601)
previousStartstring- Start of the prior comparison period (ISO 8601)
sortFieldstring- Field to sort by.one of
numberrepliesSentresponseTimeresolveTime sortOrderstring- Sort direction.one of
ASCDESC statusstring- Filter by conversation status.one of
activependingclosed tagsstring- Comma-separated tag IDs
typesstring- Filter by conversation type: email, chat, or phone.one of
emailchatphone
helpscoutmcp_get_user_drilldownGet the individual conversations for a single user over a date range.Read-onlyGet User Drilldown
Get the individual conversations for a single user over a date range. Matches conversations this user has touched at any time that were also touched within the date range, not necessarily by this user. A touch is any update: user or customer replies, notes, assignment, status changes, or workflows. This is the intended behaviour of the User report's Total Conversations / Conversation History. It does not show what the user did within the range, and no report lists only the conversations a user worked on in a range. For in-range counts use the `users` array in get_company_report. Returns a paginated conversation list. Results are paginated. Pass page=1 (default) to start; check the response for total pages and request subsequent pages as needed.
Inputs
endstringrequired- End date/time in ISO 8601 format
startstringrequired- Start date/time in ISO 8601 format
usernumberrequired- Help Scout user ID to drill into.
foldersstring- Comma-separated folder IDs
mailboxesstring- Comma-separated mailbox IDs
pagenumber- Page number for pagination
rowsinteger- Results per page (default 25, max 50).
tagsstring- Comma-separated tag IDs
typesstring- Filter by conversation type: email, chat, or phone.one of
emailchatphone
helpscoutmcp_get_user_ratingsGet the individual satisfaction ratings for a single user's conversations over a date range.Read-onlyGet User Ratings
Get the individual satisfaction ratings for a single user's conversations over a date range. Returns a paginated ratings list. Results are paginated. Pass page=1 (default) to start; check the response for total pages and request subsequent pages as needed.
Inputs
endstringrequired- End date/time in ISO 8601 format
startstringrequired- Start date/time in ISO 8601 format
usernumberrequired- Help Scout user ID.
foldersstring- Comma-separated folder IDs
mailboxesstring- Comma-separated mailbox IDs
pagenumber- Page number for pagination
previousEndstring- End of the prior comparison period (ISO 8601)
previousStartstring- Start of the prior comparison period (ISO 8601)
ratingstring- Filter by rating value. Defaults to all.one of
greatoknot-goodall sortFieldstring- Field to sort by.one of
numbermodifiedAtrating sortOrderstring- Sort direction.one of
ASCDESC tagsstring- Comma-separated tag IDs
typesstring- Filter by conversation type: email, chat, or phone.one of
emailchatphone
helpscoutmcp_get_user_statusGet one user's current status: email status (active or away) with any custom status text and emoji, and chat status with availability per inbox ID.Read-onlyGet User Status
Get one user's current status: email status (active or away) with any custom status text and emoji, and chat status with availability per inbox ID. email.updatedAt, when present, is the last time the email status or custom status was set. Only the current status is returned, not past ones. Light users have no email status. If no user has this ID, the response contains only userId, with no email or chat status.
Inputs
user_idintegerrequired- The user ID
helpscoutmcp_healthCheck server health and connectivityRead-onlyHealth Check
Check server health and connectivity
Inputs
This tool takes no inputs.
helpscoutmcp_list_attachmentsList attachments across the threads of a conversation.Read-onlyList Attachments
List attachments across the threads of a conversation. Returns filename, size, MIME type, and which thread each attachment belongs to.
Inputs
conversation_idnumberrequired- The conversation ID
helpscoutmcp_list_conversationsList or search conversations in Help Scout.Read-onlyList Conversations
List or search conversations in Help Scout. Use the `query` parameter for advanced search (e.g. query="subject:billing" or query="tag:urgent"). Omit query to list recent conversations. Supports filtering by status, mailbox, folder, tag, and more. Use `custom_fields` to filter by custom field values (requires mailbox_id; multiple entries combine with AND). Results are paginated, 25 per page, newest first by default. For the next page, send the same filters with `cursor` set to the response's `nextCursor`; if the response has a `page` object instead, request the next `page`. A response with neither is the last page.
Inputs
assigned_tonumber- Filter by assigned user ID. To find unassigned conversations, use query='(assigned:"Unassigned")' instead — passing 0 here is ignored by the API.
cursorstring- `nextCursor` from the previous response, to fetch the next page. Send the other parameters unchanged.
custom_fieldsarray- Filter conversations by custom field values. Multiple entries combine with AND — every field must match. Requires mailbox_id. Use list_inbox_custom_fields to discover field IDs and (for dropdowns) option IDs. Multiline text fields are not supported.
embedstring- Set to 'threads' to include truncated thread dataone of
threads foldernumber- Filter by folder ID
mailbox_idnumber- Filter by mailbox ID
modifiedSincestring- Only return conversations modified since this date/time (ISO 8601, e.g. 2026-01-31T00:00:00Z)
pagenumber- Page number (1-based), only for responses that carry a `page` object. Omit it for the first page.
querystring- Help Scout Inbox API conversation search syntax. Examples: "subject:refund", "email:user@example.com", "body:billing AND tag:urgent", "(assigned:\"Unassigned\")". Full syntax reference: https://developer.helpscout.com/mailbox-api/endpoints/conversations/list/
sortFieldstring- Sort field. Omit it unless the order matters: without a sort, results come newest first by conversation ID, which is faster to serve.one of
createdAtcustomerEmailmodifiedAtnumberscorestatussubjectwaitingSince sortOrderstring- Sort order. Default: descone of
ascdesc statusstring- Filter by status. Default: activeone of
activeopenclosedpendingspamall tagstring- Filter by tag name
helpscoutmcp_list_customer_emailsList email addresses for a customer.Read-onlyList Customer Emails
List email addresses for a customer.
Inputs
customer_idnumberrequired- The customer ID
helpscoutmcp_list_customer_phonesList phone numbers for a customer.Read-onlyList Customer Phones
List phone numbers for a customer.
Inputs
customer_idnumberrequired- The customer ID
helpscoutmcp_list_customersList or search customers.Read-onlyList Customers
List or search customers. Supports filtering by email, first name, last name, mailbox, and more. Results are paginated. Pass page=1 (default) to start; check the response for total pages and request subsequent pages as needed.
Inputs
emailstring- Filter by email address
firstNamestring- Filter by first name
lastNamestring- Filter by last name
mailbox_idnumber- Filter by mailbox ID
pagenumber- Page number
querystring- Help Scout Inbox API customer search syntax. Examples: '(firstName:"John")', '(email:"john@example.com")', 'modifiedAt:[2025-01-01T00:00:00Z TO *]'. Full syntax reference: https://developer.helpscout.com/mailbox-api/endpoints/customers/list/
sortFieldstring- Sort field. Defaults to createdAt. Note: the sort key for last-modified is modifiedAt, even though records carry updatedAtone of
createdAtmodifiedAtfirstNamelastName sortOrderstring- No description.one of
ascdesc
helpscoutmcp_list_inbox_custom_fieldsList custom fields for a specific inbox.Read-onlyList Inbox Custom Fields
List custom fields for a specific inbox. Results are paginated. Pass page=1 (default) to start; check the response for total pages and request subsequent pages as needed.
Inputs
mailbox_idnumberrequired- The mailbox/inbox ID
pageinteger- Page number
helpscoutmcp_list_inbox_foldersList folders within a specific inbox.Read-onlyList Inbox Folders
List folders within a specific inbox. Results are paginated. Pass page=1 (default) to start; check the response for total pages and request subsequent pages as needed.
Inputs
mailbox_idnumberrequired- The mailbox/inbox ID
pageinteger- Page number
helpscoutmcp_list_inboxesList the inboxes (mailboxes) you have access to.Read-onlyList Inboxes
List the inboxes (mailboxes) you have access to. Returns each inbox's ID, name, slug, email and timestamps. Results are paginated at 50 per page. Pass page=1 (default) to start; check the response for total pages and request subsequent pages as needed. Folders and custom fields are not included — use list_inbox_folders and list_inbox_custom_fields.
Inputs
pageinteger- Page number
helpscoutmcp_list_organizationsList organizations.Read-onlyList Organizations
List organizations. Results are paginated. Pass page=1 (default) to start; check the response for total pages and request subsequent pages as needed.
Inputs
pagenumber- Page number
helpscoutmcp_list_saved_repliesList the saved replies (canned responses) available in an inbox.Read-onlyList Saved Replies
List the saved replies (canned responses) available in an inbox. Returns the ID and name of every reply in one response — there is no pagination. Previews and full text are not included; call get_saved_reply with an ID for the body of a specific reply.
Inputs
mailbox_idnumberrequired- The mailbox/inbox ID
include_chat_repliesboolean- Also include chat-only saved replies, which are otherwise omitted. Defaults to false
helpscoutmcp_list_team_membersList members of a specific team.Read-onlyList Team Members
List members of a specific team. Results are paginated. Pass page=1 (default) to start; check the response for total pages and request subsequent pages as needed.
Inputs
team_idnumberrequired- The team ID
pageinteger- Page number
helpscoutmcp_list_teamsList teams.Read-onlyList Teams
List teams. Results are paginated. Pass page=1 (default) to start; check the response for total pages and request subsequent pages as needed.
Inputs
pageinteger- Page number
helpscoutmcp_list_threadsList threads (messages) for a conversation: customer messages, agent replies, notes, and system events.Read-onlyList Threads
List threads (messages) for a conversation: customer messages, agent replies, notes, and system events. Results are paginated at 25 per page, sorted newest first — so page 1 holds the most recent messages, and the oldest are the last entries on the last page. On a conversation the customer started, that is where their original question is. Pass page=1 (default) to start; check the response for total pages and request subsequent pages as needed. Alternatively, get_conversation with embed: 'threads' returns the threads in one call, but the response can be very large on long conversations. If it's too big, page through this tool instead.
Inputs
conversation_idnumberrequired- The conversation ID
pageinteger- Page number
helpscoutmcp_list_user_statusesList the current status of every user: email status (active or away) with any custom status text and emoji, and chat status (unavailable, available, assign, or custom) with chat.mailboxStatuses giving chat availability per inbox ID.Read-onlyList User Statuses
List the current status of every user: email status (active or away) with any custom status text and emoji, and chat status (unavailable, available, assign, or custom) with chat.mailboxStatuses giving chat availability per inbox ID. email.updatedAt, when present, is the last time the email status or custom status was set, so it does not show how long someone has been active or away. Light users are not included. Only the current status is returned, not past ones. Results are paginated, 50 users per page.
Inputs
pageinteger- Page number
helpscoutmcp_list_usersList users (team members / agents) in Help Scout.Read-onlyList Users
List users (team members / agents) in Help Scout. Results are paginated. Pass page=1 (default) to start; check the response for total pages and request subsequent pages as needed.
Inputs
pagenumber- Page number
helpscoutmcp_list_workflowsList workflows (automations) configured in the account.Read-onlyList Workflows
List workflows (automations) configured in the account. Results are paginated. Pass page=1 (default) to start; check the response for total pages and request subsequent pages as needed.
Inputs
mailbox_idnumber- Filter by mailbox ID
pagenumber- Page number
typestring- Filter by workflow typeone of
automaticmanual
helpscoutmcp_metricsGet server metrics snapshot (per-instance — each server process tracks its own counters independently)Read-onlyServer Metrics
Get server metrics snapshot (per-instance — each server process tracks its own counters independently)
Inputs
This tool takes no inputs.
helpscoutmcp_search_conversation_contentSearch for conversations by keywords in message bodies and/or subjects.Read-onlySearch Conversation Content
Search for conversations by keywords in message bodies and/or subjects. Provide plain search terms and the tool builds the Help Scout query — no query syntax required. Results are paginated, 25 per page, newest first by default. For the next page, send the same filters with `cursor` set to the response's `nextCursor`; if the response has a `page` object instead, request the next `page`. A response with neither is the last page.
Inputs
termsarrayrequired- Search terms to look for, e.g. ["billing", "refund"]. All terms must match (AND logic).
cursorstring- `nextCursor` from the previous response, to fetch the next page. Send the other parameters unchanged.
daysnumber- Only return conversations modified in the last N days
mailbox_idnumber- Filter by mailbox/inbox ID.
pagenumber- Page number (1-based), only for responses that carry a `page` object. Omit it for the first page.
search_instring- Where to search. "body" = message content, "subject" = subject line, "both" = either. Default: "both"one of
bodysubjectboth statusstring- Filter by status. Default: allone of
activeopenclosedpendingspamall tagstring- Filter results to conversations with this tag
No tools match.