Helpwise MCP server
37 operations0 webhooks
Shared team inboxes, conversations, messages, contacts, tags, and analytics for Helpwise.
Try Helpwise with your agent
Connect Helpwise, 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 Helpwise on my account, then run one read-only example and show me the result.
Helpwise tools and triggers
Tools are what your agent can do in Helpwise through Corsair's MCP server. Triggers are the Helpwise events a routine can start from.
Conversations
- AssignWrite
Assign conversation to a user
conversations.assign
- CloseWrite
Close conversations by ID
conversations.close
- DeleteDestructive
Permanently delete conversations
conversations.delete
- GetRead-only
Get a conversation by inbox and conversation ID
conversations.get
- ListRead-only
List conversations with filters and pagination
conversations.list
- Move To InboxWrite
Move conversations back to inbox
conversations.moveToInbox
- SpamWrite
Mark conversations as spam
conversations.spam
- TrashWrite
Move conversations to trash
conversations.trash
Custom Fields
- CreateWrite
Create a new custom field
customFields.create
- DeleteDestructive
Delete a custom field by ID
customFields.delete
- GetRead-only
Get custom field details by ID
customFields.get
- ListRead-only
List all custom fields
customFields.list
- List By InboxRead-only
List custom fields enabled for an inbox
customFields.listByInbox
- UpdateWrite
Update a custom field by ID
customFields.update
- Update By InboxWrite
Update inbox custom field visibility
customFields.updateByInbox
Contacts
- CreateWrite
Create a new contact
contacts.create
- GetRead-only
Get a contact by ID
contacts.get
- ListRead-only
List contacts with pagination
contacts.list
- SearchRead-only
Search contacts by term
contacts.search
- UpdateWrite
Update an existing contact by ID
contacts.update
Messages
- List EmailsRead-only
List emails in a conversation thread
messages.listEmails
- Send ChatDestructive
Send a live chat message in a thread
messages.sendChat
- Send EmailDestructive
Send an email message through a Helpwise mailbox
messages.sendEmail
- Send SmsDestructive
Send an SMS message
messages.sendSms
- Send Whats AppDestructive
Send a WhatsApp message
messages.sendWhatsApp
Tags
- ApplyWrite
Apply tags to conversations
tags.apply
- GetRead-only
Get tag details by ID
tags.get
- ListRead-only
List all tags
tags.list
- RemoveWrite
Remove tags from conversations
tags.remove
Inboxes
- GetRead-only
Get mailbox details by ID
inboxes.get
- ListRead-only
List shared mailboxes and inboxes
inboxes.list
Reports
- Get OverallRead-only
Get overall account analytics report
reports.getOverall
- Get TagsRead-only
Get tag analytics report for an inbox
reports.getTags
Users
- Get MeRead-only
Get current authenticated user profile
users.getMe
- ListRead-only
List users in account or mailbox
users.list
Notes
- CreateWrite
Add an internal note to a conversation thread
notes.create
- List TemplatesRead-only
List WhatsApp message templates
whatsapp.listTemplates
Connect Helpwise to Claude, ChatGPT or Cursor
- 1
Connect Helpwise in Corsair
Add your Helpwise API key once in Corsair. Corsair stores the credential encrypted and makes the Helpwise API calls for your agent, so it never goes into a prompt or a config file. Connect Helpwise
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs Helpwise. On a ChatGPT personal plan, connect Helpwise 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, Helpwise's read and write operations run right away and its 6 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/helpwise, add the Helpwise plugin, and connect with an API key. Then call methods like corsair.helpwise.api.contacts.create() from your app. Corsair keeps each tenant isolated.
Yes. Helpwise requires an API key from your Helpwise account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit Helpwise, GitHub, Notion, Stripe, and the rest. Trigger Helpwise from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for shared team inboxes, conversations, messages, contacts, tags, and analytics for Helpwise. Common builds include sync jobs, admin tooling, and agents that call Helpwise 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 Helpwise 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/helpwise in the open repo. When Helpwise 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 Helpwise data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store Helpwise 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 Helpwise 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 6 destructive Helpwise operations. You can change a link's mode at hub.corsair.dev/me.