data
Helpscout MCP, CLI, and Lua Integration for AI Agents
Helpscout integration docs for AI agents: MCP gateway setup, Helpscout CLI commands, Lua API reference, credentials, and function schemas.Helpscout for agents
Credentials can be configured manually in web or CLI hosts.
Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.
Agent Surfaces
Machine-Readable Metadata
Function Catalog
| Function | Type | Parameters | Description |
|---|---|---|---|
helpscout.helpscout_list_conversations | Read read | 10 | List support conversations from HelpScout. Supports filtering by mailbox, status, assignee, customer, and more. Returns paginated results. |
helpscout.helpscout_get_conversation | Read read | 1 | Get full details of a specific HelpScout conversation, including threads, customer info, and custom fields. |
helpscout.helpscout_create_conversation | Write write | 11 | Create a new conversation in HelpScout. Requires a subject, customer, mailbox, and at least one thread (message or note). |
helpscout.helpscout_update_conversation | Write write | 6 | Update an existing HelpScout conversation. Change status, assignee, tags, subject, or other fields. |
helpscout.helpscout_list_customers | Read read | 8 | List or search customers in HelpScout. Supports filtering by name, email, and pagination. |
helpscout.helpscout_get_customer | Read read | 1 | Get full details of a specific HelpScout customer, including contact info, social profiles, and custom fields. |
helpscout.helpscout_create_customer | Write write | 6 | Create a new customer in HelpScout. Provide at least a name or email address. |
helpscout.helpscout_list_mailboxes | Read read | 2 | List all mailboxes in HelpScout. Returns mailbox IDs, names, and email addresses. Use mailbox IDs when creating or filtering conversations. |
helpscout.helpscout_get_mailbox | Read read | 1 | Get details of a specific HelpScout mailbox, including name, email, folders, and user assignments. |
helpscout.helpscout_get_current_user | Read read | 0 | Get the profile of the currently authenticated HelpScout user. Useful for verifying API connectivity and identifying the active account. |