# Helpwise MCP by usefulapi

> Helpwise MCP by usefulapi is an MCP server. Read Helpwise conversations, contacts, tags and reports; note, tag, assign, close; send one email. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/helpwise/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/helpwise
- **MCP Registry name:** io.usefulapi/helpwise
- **Listing updated:** 2026-11-13

## About

Read Helpwise conversations, contacts, tags and reports; note, tag, assign, close; send one email.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http helpwise https://helpwise.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://helpwise.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "helpwise": {
      "url": "https://helpwise.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "helpwise": {
      "type": "http",
      "url": "https://helpwise.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "helpwise": {
      "serverUrl": "https://helpwise.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "helpwise": {
      "type": "http",
      "url": "https://helpwise.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `helpwise_list_conversations`: List conversations (threads) of one or more inboxes, newest first, with subject, snippet, tags, assignee, read/starred/closed flags and contact. Pick the folder with `folder` (default: all). Page with `next_page_token`. Inbox ids come from helpwise_list_inboxes. GET /conversations.
- `helpwise_get_conversation`: One conversation with its messages, notes, drafts, assignment and contacts. Page long conversations with `page_token` from the previous reply. GET /inboxes/{inbox_id}/conversations/{conversation_id}.
- `helpwise_list_contacts`: List contacts (name, company, job title, emails, phones, id). Page with limit and offset. GET /contacts.
- `helpwise_search_contacts`: Search contacts by a name, email or phone term. Page with limit and offset. GET /contacts/search.
- `helpwise_get_contact`: One contact with emails, phones, company, custom fields and recent conversations. GET /contacts/{id}.
- `helpwise_list_tags`: All tags (id, name, colour, parent, inbox). Use the ids with helpwise_apply_tags. GET /tags.
- `helpwise_get_tag`: One tag by id. GET /tags/{id}.
- `helpwise_get_report`: Overall and team-performance report for a date range: new/closed/assigned conversations (with change vs the previous period), inbound/outbound messages per day, busiest hour/day, average first response, response and resolution time, CSAT and per-agent performance. Optional inbox and tag filters. GET /reports.
- `helpwise_get_tags_report`: Per-tag report for one inbox and a date range: conversations per tag (and share), open conversations, average response, first-response and resolution time. GET /inboxes/{inbox_id}/reports/tags.
- `helpwise_list_inboxes`: List the account's inboxes (mailboxes) with id, name, address and type. Use the ids in the other tools. POST /mailboxes/list (V0).
- `helpwise_list_users`: List the team members (agents) with access to an inbox: id, name, email. Use the ids with helpwise_assign_conversation. POST /users/list (V0).
- `helpwise_get_current_user`: The Helpwise user the API key belongs to (name, email, id). POST /users/me (V0).
- `helpwise_create_contact`: WRITE: create a new contact in Helpwise (name, company, job title, emails, phones, custom fields). Nothing is sent to the person. Creating the same email twice may create a duplicate. POST /contacts.
- `helpwise_update_contact`: WRITE: change a contact's name, company, job title, emails, phones or custom fields. Helpwise updates with PUT, so this tool first reads the contact and sends the current values together with your changes; a list you pass (emails, phones, custom_fields) REPLACES the old list. Nothing is sent to the person. PUT /contacts/{id}.
- `helpwise_add_note`: WRITE: add an internal note to a conversation. Visible to your Helpwise team only; it is not sent to the customer. Notes cannot be deleted through this API. POST /notes/add (V0).
- `helpwise_assign_conversation`: WRITE: assign a conversation to a team member (user id from helpwise_list_users), or pass assigned_to 0 to unassign it. The assignee may be notified by Helpwise. POST /threads/assign (V0).
- `helpwise_close_conversations`: WRITE: close up to 25 conversations (mark them done). They can be reopened with helpwise_reopen_conversations. Nothing is sent to customers. PUT /conversations/action/close.
- `helpwise_reopen_conversations`: WRITE: move up to 25 conversations back to the inbox (reopen closed ones). Nothing is sent to customers. PUT /conversations/action/moveToInbox.
- `helpwise_apply_tags`: WRITE: apply existing tags (ids from helpwise_list_tags) to up to 25 conversations. Tags can drive Helpwise automations. Applying a tag already present changes nothing. POST /tags/apply.
- `helpwise_remove_tags`: WRITE: take tags off up to 25 conversations. The tags themselves are not deleted. POST /tags/remove.
- `helpwise_send_email`: WRITE: SEND A REAL EMAIL from a Helpwise inbox to the given customer address(es). Irreversible; once sent it cannot be recalled. At most 10 recipients in total (to + cc), one message per call; never use it for lists or campaigns. This starts a new message (it is not a reply on an existing conversation). The body is plain text (blank line = new paragraph); it is sent as HTML. POST /emails/send_mail

## FAQ

### How do I add Helpwise MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http helpwise https://helpwise.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/helpwise-mcp-by-usefulapi
