Help Scout MCP server
55 operations0 webhooks
Manage mailboxes, conversations, customer profiles, threads, tags, saved replies, and reports with Help Scout Mailbox API 2.0.
Try Help Scout with your agent
Connect Help Scout, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in Help Scout on my account, then run one read-only example and show me the result.
Help Scout tools and triggers
Tools are what your agent can do in Help Scout through Corsair's MCP server. Triggers are the Help Scout events a routine can start from.
Customers
- CreateWrite
Create a new customer profile
customers.create
- Create AddressWrite
Create customer physical address
customers.createAddress
- Create ChatWrite
Add a chat handle to a customer
customers.createChat
- Create EmailWrite
Add an email address to a customer
customers.createEmail
- Create PhoneWrite
Add a phone number to a customer
customers.createPhone
- Create Social ProfileWrite
Add a social profile to a customer
customers.createSocialProfile
- Create WebsiteWrite
Add a website URL to a customer
customers.createWebsite
- DeleteDestructive
Delete a customer with their conversations and survey responses (cannot be undone)
customers.delete
- Delete AddressDestructive
Delete customer physical address
customers.deleteAddress
- Delete ChatDestructive
Delete a chat handle from a customer
customers.deleteChat
- Delete EmailDestructive
Delete an email address from a customer
customers.deleteEmail
- Delete PhoneDestructive
Delete a phone number from a customer
customers.deletePhone
- Delete Social ProfileDestructive
Delete a social profile from a customer
customers.deleteSocialProfile
- Delete WebsiteDestructive
Delete a website URL from a customer
customers.deleteWebsite
- GetRead-only
Get details of a specific customer by ID
customers.get
- ListRead-only
List and search customers in Help Scout
customers.list
- PatchWrite
Partially update customer profile fields
customers.patch
- UpdateDestructive
Overwrite an existing customer profile
customers.update
- Update AddressWrite
Update customer physical address
customers.updateAddress
- Update ChatWrite
Update an existing customer chat handle
customers.updateChat
- Update EmailWrite
Update an existing customer email address
customers.updateEmail
- Update PhoneWrite
Update an existing customer phone number
customers.updatePhone
- Update Social ProfileWrite
Update an existing customer social profile
customers.updateSocialProfile
- Update WebsiteWrite
Update an existing customer website URL
customers.updateWebsite
Threads
- Create ChatWrite
Create a chat thread on a conversation
threads.createChat
- Create CustomerWrite
Create a customer message thread on a conversation
threads.createCustomer
- Create NoteWrite
Create an internal note thread on a conversation
threads.createNote
- Create PhoneWrite
Create a phone call log thread on a conversation
threads.createPhone
- Create ReplyDestructive
Create a reply thread sent to the customer
threads.createReply
- Get Original SourceRead-only
Get original email source of a thread
threads.getOriginalSource
- ListRead-only
List all threads in a conversation
threads.list
- UpdateWrite
Update thread text or visibility
threads.update
Conversations
- CreateDestructive
Create a new conversation with initial thread
conversations.create
- DeleteDestructive
Delete a conversation permanently
conversations.delete
- GetRead-only
Get a specific Help Scout conversation by ID
conversations.get
- ListRead-only
List and filter conversations in Help Scout
conversations.list
- UpdateWrite
Update fields of a conversation via JSON Patch
conversations.update
- Update FieldsDestructive
Update custom field values on a conversation
conversations.updateFields
- Update TagsDestructive
Update tags assigned to a conversation
conversations.updateTags
Reports
- Get ChatRead-only
Get live chat channel report metrics
reports.getChat
- Get CompanyRead-only
Get overall company performance report metrics
reports.getCompany
- Get ConversationsRead-only
Get aggregate conversations report metrics
reports.getConversations
- Get DocsRead-only
Get Help Scout Docs knowledge base report metrics
reports.getDocs
- Get EmailRead-only
Get email channel performance report metrics
reports.getEmail
Saved Replies
- CreateWrite
Create a saved reply in a mailbox
savedReplies.create
- DeleteDestructive
Delete a saved reply from a mailbox
savedReplies.delete
- GetRead-only
Get a saved reply by ID
savedReplies.get
- ListRead-only
List saved replies for a mailbox
savedReplies.list
- UpdateWrite
Update an existing saved reply
savedReplies.update
Mailboxes
- GetRead-only
Get details of a specific Help Scout mailbox
mailboxes.get
- ListRead-only
List mailboxes in Help Scout
mailboxes.list
Tags
- GetRead-only
Get details of a tag by ID
tags.get
- ListRead-only
List all tags used across mailboxes
tags.list
Custom Fields
- ListRead-only
List custom fields configured on a mailbox
customFields.list
Folders
- ListRead-only
List folders belonging to a mailbox
folders.list
Connect Help Scout to Claude, ChatGPT or Cursor
- 1
Connect Help Scout in Corsair
Sign in to Help Scout or add an API key once in Corsair. Corsair stores the credential encrypted and makes the Help Scout API calls for your agent, so it never goes into a prompt or a config file. Connect Help Scout
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs Help Scout. On a ChatGPT personal plan, connect Help Scout here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, Help Scout's read and write operations run right away and its 14 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/helpscout, add the Help Scout plugin, and connect with OAuth or an API key. Then call methods like corsair.helpscout.api.conversations.create() from your app. Corsair stores tokens, and keeps each tenant isolated.
Yes. Help Scout supports OAuth or an API key. Use credentials or OAuth scopes that match what you automate. Create them in the Help Scout developer console, then paste into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit Help Scout, GitHub, Notion, Stripe, and the rest. Trigger Help Scout from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for manage mailboxes, conversations, customer profiles, threads, tags, saved replies, and reports with Help Scout Mailbox API 2.0. Common builds include sync jobs, admin tooling, and agents that call Help Scout APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per Help Scout API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/helpscout in the open repo. When Help Scout ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your Help Scout data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store Help Scout data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put Help Scout on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 14 destructive Help Scout operations. You can change a link's mode at hub.corsair.dev/me.