Help Scout MCP. Manage customer tickets and history in natural conversation.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Help Scout. Connect your help desk to any AI agent to manage customer support, tickets, and team notes. Use our tools to list active conversations, check customer history, add internal notes, and track satisfaction ratings directly from your workflow.
It gives your agent the full context needed to act like a dedicated Support Coordinator.
What your AI agents can do
Create convo note
Adds a private note to a specific conversation for internal team reference.
Get conversation
Retrieves all details and transcripts for a single, specific support conversation.
Get customer
Gets the detailed profile and history for a specific customer.
List all support conversations or run advanced searches across your entire history.
Get detailed customer profiles and list all registered users in your help desk.
Add private internal notes or change a conversation's status (e.g., pending, closed) directly through the chat.
List configured mailboxes, available tags, and automated workflows to verify your operational setup.
Retrieve customer satisfaction ratings and list all available support workflows.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Help Scout on Vinkius019d75afcreate convo note
Adds a private note to a specific conversation for internal team reference.
019d75afget conversation
Retrieves all details and transcripts for a single, specific support conversation.
019d75afget customer
Gets the detailed profile and history for a specific customer.
019d75aflist conversations
Lists all currently active support threads and open tickets.
019d75aflist customer ratings
Retrieves a list of recent customer satisfaction scores.
019d75aflist customers
Lists every customer registered in the help desk.
019d75aflist mailboxes
Lists all configured email inboxes used for support intake.
019d75aflist staff users
Lists all support agents and users within the tenant.
019d75aflist tags
Lists all available tags used to categorize conversations.
019d75aflist workflows
Lists all automated support workflows and rules.
019d75afsearch conversations
Searches through the entire conversation history using keywords or criteria.
019d75afupdate convo status
Changes the status of a conversation (e.g., active, pending, closed).
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Help Scout, then connect any of our 4,800+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,800+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Help Scout. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 12 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Checking a customer's full history shouldn't feel like a database query.
Today, checking a customer's full picture means opening the help desk console, finding their profile, then manually clicking into the conversation history. You might need to switch tabs to check their tags or look up their last rating. It’s slow, and you’re always worried about missing a critical interaction.
With this MCP server, you just ask your agent. It runs `get_customer` and `list_conversations` in the background, compiling everything—the profile, the open tickets, and the last CSAT score—into one single, actionable summary. You get the full 360 view, instantly.
Help Scout MCP Server: Manage tickets and customer data.
Before, updating a ticket status or adding an internal note was a multi-step process: open the ticket, find the status field, click the dropdown, and then find the 'internal notes' section. It required manual attention every time.
Now, you just instruct your agent to update the status or add the note. The server handles the API calls—running `update_convo_status` or `create_convo_note`—and confirms the change. The process is direct, contained, and leaves a perfect audit trail.
What you can do with this MCP connector
You'll connect your Help Scout help desk to your AI agent, giving it the full context it needs to handle customer support and team operations. Your agent can list all active support threads and run advanced searches across your entire conversation history. It can pull up detailed profiles and history for any specific customer.
You can also list every customer registered in your help desk, and even list all the support agents and users within the tenant. When you're working on a ticket, your agent can retrieve all details and transcripts for a single conversation. You can write private notes to a specific conversation for internal team reference, and you can change a conversation's status—like setting it to pending or closed.
To audit your setup, your agent can list all configured email inboxes used for support intake, list all available tags used to categorize conversations, and list all automated support workflows and rules. You can list all currently active support threads and run advanced searches across your entire history. You can retrieve customer satisfaction ratings to measure support performance.
You'll also be able to list all available support workflows and rules. You'll use the tools to manage customer communication and support operations right from your chat window.
019d75af-9d07-7051-9ac8-ccec2f049ae5 
How Help Scout MCP Works
- 1 Subscribe to this server and provide your Help Scout OAuth Access Token.
- 2 Your AI client connects to the server and identifies the necessary action (e.g., 'I need to know the status of the billing issue').
- 3 The server executes the required tool (e.g.,
get_conversation) and returns the structured data to your AI client for a natural language summary.
The bottom line is that your AI client handles all the data calls; you just talk to it.
Who Is Help Scout MCP For?
Support Managers, Customer Success Teams, and Operations Leaders. If your job involves tracking customer complaints, reviewing ticket history, or coordinating responses across multiple agents, this is for you. You're tired of switching between the help desk UI, the CRM, and the internal notes sheet. You need one central point of truth.
Uses list_conversations to check agent workloads and quickly retrieve conversation summaries across all active threads.
Uses get_customer and create_convo_note to check client history and add internal follow-up notes without alerting the customer.
Uses list_mailboxes and list_workflows to audit the entire help desk setup, ensuring tags and automations are configured correctly.
What Changes When You Connect
- Full Customer Context: Stop jumping between tools. Use
get_customerandlist_conversationsto instantly pull up a customer's full history and current active threads in one go. - Zero-Touch Collaboration: Never lose an internal thought. Use
create_convo_noteto add private notes to a ticket. This keeps the customer out of the loop while giving your team the full context they need. - Operational Visibility: Quickly audit your setup. Run
list_mailboxesorlist_workflowsto see exactly which inboxes are receiving tickets and what automation rules are running. - Proactive Status Management: When a fix is pending, use
update_convo_statusto change a ticket from 'Active' to 'Pending'. Your agent manages the lifecycle, not you. - Performance Measurement: Track success metrics easily. Call
list_customer_ratingsto get the latest CSAT scores and measure the actual health of your support process. - Deep Search Capabilities: Don't rely on keyword matching. Use
search_conversationsto dig through years of history and find the specific answer you need instantly.
Real-World Use Cases
The Customer Needs a Refund (Support Manager)
A manager needs to know if John Doe has been contacting support about refunds before. They ask the agent to run get_customer for John Doe. The agent gets the profile, sees the history, and can confirm the last interaction was a billing query, allowing them to respond accurately.
Client Follow-up Requires Internal Notes (Customer Success Manager)
A CSM is calling a client to follow up. They ask the agent to run create_convo_note on the client's active ticket. The note confirms an internal follow-up date, ensuring the client never sees the internal coordination details.
Auditing a New Mailbox Setup (Operations Lead)
The ops lead needs to verify that the new 'Billing' mailbox is correctly configured. They ask the agent to run list_mailboxes and then list_tags to ensure all necessary categories and incoming channels are accounted for.
Finding a Specific Error from 6 Months Ago (Support Agent)
A support agent needs to find an obscure API error mentioned in a conversation from half a year ago. They instruct the agent to use search_conversations with specific keywords and a date range, retrieving the exact thread ID for immediate follow-up.
The Tradeoffs
Manual Dashboard Cross-Referencing
Opening the help desk, switching to the CRM, copying the customer ID, then opening the tag list, and manually checking the status. This takes five minutes and risks missing details.
→
Just ask your agent to run get_customer and list_conversations. The agent pulls the profile and the active threads simultaneously, giving you the full 360-degree view in seconds.
Guessing the Ticket Status
Thinking a ticket is 'Closed' because the customer stopped replying, but forgetting to run update_convo_status to formally mark it. This messes up reporting and workload tracking.
→
Don't guess. Use update_convo_status to formally change the status. This action logs the change and keeps your reporting accurate.
Searching only by keywords
Running a search and only getting vague results because you missed a related conversation. You are missing the full context.
→
Use search_conversations to find the initial thread, then use get_conversation on the ID to retrieve the full, complete transcript for context.
When It Fits, When It Doesn't
Use this server if your core job revolves around customer service, support coordination, or operational auditing of a help desk. You need to synthesize data from multiple sources—customer profiles, ticket history, and internal status—to act on a single request. You're looking for the full context, not just a single piece of data.
Don't use this if you only need to check a simple list of users, or if your support data is stored outside Help Scout. If your process is highly specialized (e.g., only tracking inventory levels), you need a different tool. If you only need to list tags, use list_tags directly, but for anything that involves customer history or conversation status, this is the right choice.
Common Questions About Help Scout MCP
How do I use the `list_conversations` tool with Help Scout MCP Server? +
The agent runs list_conversations to pull a list of all active support threads. You can then follow up by asking the agent to get details for a specific conversation ID, like get_conversation(ID).
What is the difference between `list_conversations` and `search_conversations`? +
list_conversations gives you a count of currently open tickets. search_conversations lets you search through the entire history using keywords, like searching for 'billing error' across all past chats.
Can I add internal notes using the `create_convo_note` tool? +
Yes. create_convo_note adds a private, internal note to a conversation ID. The customer will never see this note, keeping your team's communication separate from the customer view.
Does the `get_customer` tool provide all historical data? +
The get_customer tool provides the customer's detailed profile and historical interactions. It's your starting point for any customer-facing query.
How do I manage ticket statuses with `update_convo_status`? +
You tell the agent to update the status. You provide the conversation ID and the new status (e.g., 'Pending'). The agent runs update_convo_status and logs the change.
How do I check all available tags using the `list_tags` tool? +
It lists every tag configured in your help desk. This helps you see what categories are available for classifying conversations, ensuring you don't miss a proper workflow tag.
What is the difference between `list_mailboxes` and `list_staff_users`? +
The list_mailboxes tool shows all supported inboxes. The list_staff_users tool lists every agent account within your help desk, letting you know who can access and manage the support tickets.
How do I find customer ratings using `list_customer_ratings`? +
It retrieves a list of recent customer satisfaction scores. You can monitor the overall health of your support operations and spot trends in customer happiness quickly.
How do I get my Help Scout Access Token? +
You can generate an OAuth2 Access Token by creating an application in the Help Scout Developer Portal (developer.helpscout.com). Alternatively, if you are using a personal script, you can use the Client Credentials flow to obtain a token.
Can I add internal notes to conversations? +
Yes! Use the create_convo_note tool. You must provide the conversation_id and the text of your note. This allows you to collaborate with your team without the customer seeing the message.
How do I change the status of a support thread? +
Use the update_convo_status tool. Provide the conversation ID and the new status (active, pending, or closed). This helps you keep your mailbox organized.
Is the integration secure for managing support data? +
Absolutely. The integration uses industry-standard OAuth 2.0 Bearer tokens over HTTPS. Your credentials are encrypted and stored securely within the Vinkius Cloud infrastructure.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.