Skip to main content
skill CX Codex

helpdesk-automation — Claude Code skill: what it does, how to install

helpdesk-automation reads HelpDesk tickets, agent views, and canned replies through Rube MCP and Composio. Built for support agents managing ticket backlogs.

MIT 124 installs ★ 3,785 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add davepoon/buildwithclaude --skill helpdesk-automation -a claude-code
Open on GitHub

What helpdesk-automation does

This skill equips coding assistants with read-only access to HelpDesk via Composio's toolkit on Rube MCP. It lets the agent list support tickets, inspect predefined agent views, fetch saved canned response templates, and review custom field configurations.

Ticket retrieval relies on cursor-based pagination requiring both timestamp and ID pairs. Folders like tickets, archive, trash, and spam exist in separate silos without cross-folder querying, so pagination must target one silo at a time. The page size caps at 100 entries, with sorting by creation, update, or last message timestamp.

All current operations are strictly read-only, meaning ticket creation and reply posting are not handled here. You must add the remote server at https://rube.app/mcp to your MCP configuration and ensure the helpdesk connection is active before calling any tool.

What it helps with

  • fetch recent support tickets sorted by update time
  • inspect predefined canned replies to reuse common messaging
  • read custom field schemas configured in the HelpDesk account
  • navigate archived or spam ticket folders using cursor pagination

Example prompts for the agent

  • List the latest active HelpDesk tickets sorted by lastMessageAt
  • Fetch all available canned response templates from HelpDesk
  • Show the custom field definitions used in our HelpDesk tickets

How to install helpdesk-automation

1Skills CLI (Vercel)

npx skills add davepoon/buildwithclaude --skill helpdesk-automation -a claude-code

2Manually: put the files in place

~/.claude/skills/helpdesk-automation/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/helpdesk-automation/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about helpdesk-automation

How to install helpdesk-automation in Claude Code?

Run npx skills add davepoon/buildwithclaude --skill helpdesk-automation -a claude-code in your terminal.

What prerequisites are required before using helpdesk-automation?

Add https://rube.app/mcp as an MCP server, invoke RUBE_MANAGE_CONNECTIONS with toolkit helpdesk, and authenticate via the returned URL until status shows ACTIVE.

Can helpdesk-automation create or reply to tickets?

No, the toolkit operations in this skill are strictly read-only and cover listing tickets, views, canned responses, and custom fields.

Source text

SKILL.md · MIT
---
name: helpdesk-automation
description: "Automate HelpDesk tasks via Rube MCP (Composio): list tickets, manage views, use canned responses, and configure custom fields. Always search tools first for current schemas."
requires:
  mcp: [rube]
category: customer-support
---

# HelpDesk Automation via Rube MCP

Automate HelpDesk ticketing operations through Composio's HelpDesk toolkit via Rube MCP.

**Toolkit docs**: [composio.dev/toolkits/helpdesk](https://composio.dev/toolkits/helpdesk)

## Prerequisites

- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active HelpDesk connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `helpdesk`
- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas

## Setup

**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.


1. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds
2. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `helpdesk`
3. If connection is not ACTIVE, follow the returned auth link to complete HelpDesk authentication
4. Confirm connection status shows ACTIVE before running any workflows

## Core Workflows

### 1. List and Browse Tickets

**When to use**: User wants to retrieve, browse, or paginate through support tickets

**Tool sequence**:
1. `HELPDESK_LIST_TICKETS` - List tickets with sorting and pagination [Required]

**Key parameters**:
- `silo`: Ticket folder - 'tickets', 'archive', 'trash', or 'spam' (default: 'tickets')
- `sortBy`: Sort field - 'createdAt', 'updatedAt', or 'lastMessageAt' (default: 'createdAt')
- `order`: Sort direction - 'asc' or 'desc' (default: 'desc')
- `pageSize`: Results per page, 1-100 (default: 20)
- `next.value`: Timestamp cursor for forward pagination
- `next.ID`: ID cursor for forward pagination
- `prev.value`: Timestamp cursor for backward pagination
- `prev.ID`: ID cursor for backward pagination

**Pitfalls**:
- Pagination uses cursor-based approach with timestamp + ID pairs
- Forward pagination requires both `next.value` and `next.ID` from previous response
- Backward pagination requires both `prev.value` and `prev.ID`
- `silo` determines which folder to list from; default is active tickets
- `pageSize` max is 100; default is 20
- Archived and trashed tickets are in separate silos

### 2. Manage Ticket Views

**When to use**: User wants to see saved agent views for organizing tickets

**Tool sequence**:
1. `HELPDESK_LIST_VIEWS` - List all agent views [Required]

**Key parameters**: (none required)

**Pitfalls**:
- Views are predefined saved filters configured by agents in the HelpDesk UI
- View definitions include filter criteria that can be used to understand ticket organization
- Views cannot be created or modified via API; they are managed in the HelpDesk UI

### 3. Use Canned Responses

**When to use**: User wants to list available canned (template) responses for tickets

**Tool sequence**:
1. `HELPDESK_LIST_CANNED_RESPONSES` - Retrieve all predefined reply templates [Required]

**Key parameters**: (none required)

**Pitfalls**:
- Canned responses are predefined templates for common replies
- They may include placeholder variables that need to be filled in
- Canned responses are managed through the HelpDesk UI
- Response content may include HTML formatting

### 4. Inspect Custom Fields

**When to use**: User wants to view custom field definitions for the account

**Tool sequence**:
1. `HELPDESK_LIST_CUSTOM_FIELDS` - List all custom field definitions [Required]

**Key parameters**: (none required)

**Pitfalls**:
- Custom fields extend the default ticket schema with organization-specific data
- Field definitions include field type, name, and validation rules
- Custom fields are configured in the HelpDesk admin panel
- Field values appear on tickets when the field has been populated

## Common Patterns

### Ticket Browsing Pattern

```
1. Call HELPDESK_LIST_TICKETS with desired silo and sortBy
2. Process the returned page of tickets
3. Extract next.value and next.ID from the response
4. Call HELPDESK_LIST_TICKETS with those cursor values for next page
5. Continue until no more cursor values are returned
```

### Ticket Folder Navigation

```
Active tickets:  silo='tickets'
Archived:        silo='archive'
Trashed:         silo='trash'
Spam:            silo='spam'
```

### Cursor-Based Pagination

```
Forward pagination:
  - Use next.value (timestamp) and next.ID from response
  - Pass as next.value and next.ID parameters in next call

Backward pagination:
  - Use prev.value (timestamp) and prev.ID from response
  - Pass as prev.value and prev.ID parameters in next call
```

## Known Pitfalls

**Cursor Pagination**:
- Both timestamp and ID are required for cursor navigation
- Cursor values are timestamps in ISO 8601 date-time format
- Mixing forward and backward cursors in the same request is undefined behavior

**Silo Filtering**:
- Tickets are physically separated into silos (folders)
- Moving tickets between silos is done in the HelpDesk UI
- Each silo query is independent; there is no cross-silo search

**Read-Only Operations**:
- Current Composio toolkit provides list/read operations
- Ticket creation, update, and reply operations may require additional tools
- Check RUBE_SEARCH_TOOLS for any newly available tools

**Rate Limits**:
- HelpDesk API has per-account rate limits
- Implement backoff on 429 responses
- Keep page sizes reasonable to avoid timeouts

**Response Parsing**:
- Response data may be nested under `data` or `data.data`
- Parse defensively with fallback patterns
- Ticket IDs are strings

## Quick Reference

| Task | Tool Slug | Key Params |
|------|-----------|------------|
| List tickets | HELPDESK_LIST_TICKETS | silo, sortBy, order, pageSize |
| List views | HELPDESK_LIST_VIEWS | (none) |
| List canned responses | HELPDESK_LIST_CANNED_RESPONSES | (none) |
| List custom fields | HELPDESK_LIST_CUSTOM_FIELDS | (none) |

---
*Powered by [Composio](https://composio.dev)*

© davepoon · MIT · davepoon/buildwithclaude

Similar skills

All skills for Automation and no-code: n8n, Zapier, Make →

From the same set235

The whole set →
make-automation make-automation is a Claude Code skill that uses Rube MCP to inspect Make scenario operation logs and validate language codes and IANA timezones. CX Codex +1 125installs render-automation render-automation — a skill to automate Render cloud operations through Rube MCP and Composio. List services, trigger deployments, and monitor status from your IDE. CX Codex +1 125installs bamboohr-automation bamboohr-automation is a Claude Code skill for BambooHR operations: searching employees, managing time off, updating data, and handling dependents and benefits. CX Codex +1 124installs datadog-automation datadog-automation automates Datadog tasks: query metrics, search logs, manage monitors and dashboards, create events and downtimes. Requires connected Rube MCP and active Datadog authentication. CX Codex +1 124installs sentry-automation sentry-automation is a Claude Code skill for managing Sentry errors, alerts, and releases via Rube MCP. Search issues, inspect events, and track deployments from your IDE. CX Codex +1 123installs cal-com-automation cal-com-automation automates Cal.com scheduling, availability lookups, and webhooks via Rube MCP. Useful when an agent needs to manage booking slots or team calendars directly. CX Codex +1 123installs segment-automation The segment-automation skill connects an agent to Segment through Rube MCP for events, user profiles, groups, page views, and batch requests. CX Codex +1 123installs convertkit-automation convertkit-automation automates ConvertKit (Kit) workflows via Rube MCP: search and filter subscribers, assign tags, view broadcasts, and pull campaign stats. Requires Rube MCP and an active Kit connection. CX Codex +1 123installs

Project sponsors

Companies that keep this analytics open