Help Scout MCP server for your AI

Create a Docs article.

Create a Docs collection.

Retrieve a Docs article by id (or number).

Retrieve a Docs collection by id (or number).

List the articles in a Docs collection (returns abbreviated ArticleRef objects).

List Docs collections.

Search Docs articles (returns ArticleSearch objects with preview/docsUrl).

Update a Docs article.

Retrieve the Company Overall report (top-line metrics).

Retrieve the Conversations Overall report.

Retrieve the Happiness Overall report (satisfaction ratings).

Retrieve the Productivity Overall report.

Create a customer.

Add an email to a customer.

Add a phone to a customer.

Retrieve a single customer by id, including embedded emails, phones, chats, social profiles, websites, address, and properties.

List customers, optionally filtered by name, modified date, inbox, or advanced search query.

Overwrite a customer's CORE fields (full replace).

Update a customer partially via JSON-Patch (only the fields you include change).

Create a conversation (ticket).

Add a customer thread (an inbound customer message) to a conversation.

Add an internal note thread to a conversation (not visible to the customer).

Add a reply thread (an outbound agent message) to a conversation.

Delete a conversation by id.

Retrieve a single conversation by id, including status, assignee, primary customer, tags, custom fields, and source.

List the threads (messages, notes, line-items) in a conversation, newest first.

List conversations in the account, optionally filtered by mailbox, folder, status, tag, assignee, modified date, or advanced search query.

Update a conversation via a single JSON-Patch operation (change subject, status, assignee, inbox, primary customer, or publish a draft).

Set the custom field values on a conversation.

Set the tags on a conversation.

Create a webhook subscription.

Delete a webhook by id.

Retrieve a single webhook by id.

List the account's webhooks (the `secret` is never returned).

Retrieve a single inbox (mailbox) by id.

List an inbox's custom field DEFINITIONS.

List the folders in an inbox (e.g.

List the inboxes (mailboxes) in the account.

Retrieve the authenticated user (the owner of the OAuth token).

Retrieve a single user (agent) by id.

List the users (agents) in the account, including those who have not yet accepted their invitations.

List the members (users) of a team.

List the teams in the account (Plus/Pro plans).

List the account's workflows (manual and automatic).

Run a MANUAL workflow against a set of conversations (max 50 ids; all must belong to the same inbox as the workflow).

List all tags in the account, alphabetically.

Create a Docs category.

Create a Docs redirect.

Create a Docs site.

Delete a Docs article by id.

Delete an article's draft.

Delete a Docs category by id.

Delete a Docs collection by id.

Delete a Docs redirect by id.

Delete a Docs site by id.

Find the final destination of a redirect for a source URL (follows the full chain).

Retrieve a single article revision by REVISION id (full ArticleRevision incl.

Retrieve a Docs category by id (or number).

Retrieve a single redirect by id.

Retrieve a Docs site by id.

List an article's revisions (ArticleRevisionRef — no text field).

List the articles in a Docs category (returns abbreviated ArticleRef objects).

List the categories in a Docs collection.

List the redirects for a Docs site.

List articles related to a given article (returns ArticleRef objects).

List Docs sites.

Create or update an article's draft without touching the published version.

Increment an article's view count (feeds popularity).

Update a Docs category (full object; name required).

Reorder categories within a collection.

Update a Docs collection (full object; name required).

Update a Docs redirect (siteId, urlMapping, redirect all required).

Update a Docs site (full object; subDomain + title still required).

Retrieve the Chat channel report (Beacon-native chats).

Retrieve the Company Customers Helped report.

Retrieve the Company Drilldown report (conversation-level rows).

Retrieve the Busiest Time of Day report.

Retrieve the Conversations Drilldown report (conversation-level rows).

Retrieve the Conversations Drilldown by Field report.

Retrieve the New Conversations report.

Retrieve the New Conversations Drilldown report.

Retrieve the Received Messages Statistics report (customer-initiated messages only).

Retrieve the Conversations Volume by Channel report.

Retrieve the Docs Overall report.

Retrieve the Email channel report.

Retrieve the Happiness Ratings report (per-rating drilldown).

Retrieve the Phone channel report.

Retrieve the First Response Time report.

Retrieve the Replies Sent report.

Retrieve the Resolution Time report.

Retrieve the Resolved report.

Retrieve the Response Time report.

Retrieve the User/Team Chat report.

Retrieve the User Conversation History report (one row per reply — duplicate conversation entries are possible).

Retrieve the User Customers Helped report.

Retrieve the User Drilldown report (conversation-level rows).

Retrieve the User Happiness report.

Retrieve the User (or Team) Overall report.

Retrieve the User Happiness Ratings (drilldown) report.

Retrieve the User Replies report.

Retrieve the User Resolutions report.

Set a customer's address (singleton — at most one per customer).

Add a chat handle to a customer.

Add a social profile to a customer.

Add a website to a customer.

Delete a customer's address.

Delete a customer's chat handle by id.

Delete a customer's email by id.

Delete a customer's phone by id.

Delete a customer's social profile by id.

Delete a customer's website by id.

List a customer's chat handles.

List a customer's emails.

List a customer's phones.

List a customer's social profiles.

List a customer's websites.

Update a customer's address (full replace of the singleton).

Update a customer's chat handle by id (full replace).

Update a customer's email by id (full replace).

Update a customer's phone by id (full replace).

Set or clear a customer's custom properties via JSON-Patch.

Update a customer's social profile by id (full replace).

Update a customer's website by id (full replace).

Add a chat thread to a conversation.

Add a phone thread to a conversation.

Delete an attachment.

Remove a conversation's snooze and re-file it based on assignee.

Retrieve an attachment's contents as base64.

Retrieve the original source (raw message) of a thread.

Set the primary customer of a conversation.

Snooze a conversation until a future time.

Edit a thread's text or hide/unhide it via JSON-Patch.

Update a webhook (full replacement — url, events, and secret are required again).