# freshservice-automation

freshservice-automation handles Freshservice ITSM workflows through Rube MCP, covering ticket creation, searches, bulk updates, and service requests.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 121 installs · ★ 3785 repo stars
- Author: davepoon
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/davepoon/buildwithclaude/tree/HEAD/plugins/all-skills/skills/freshservice-automation/SKILL.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/freshservice-automation

## What it does

This skill coordinates Freshservice ITSM operations using Composio tools exposed by Rube MCP. Setup requires adding `https://rube.app/mcp` as an MCP server endpoint in your client config, then verifying an ACTIVE connection state via `RUBE_MANAGE_CONNECTIONS` with the `freshservice` toolkit.

Workflows map directly to API endpoints. It handles reading tickets through `FRESHSERVICE_LIST_TICKETS`, logging incidents with HTML details, updating batches via `FRESHSERVICE_BULK_UPDATE_TICKETS`, and requesting catalog items. Statuses and priorities expect numeric identifiers rather than text labels: priority 1 maps to Low, whereas 4 represents Urgent.

Standard listing queries fetch only records from the last 30 days. To pull older tickets, the agent must supply an explicit `updated_since` timestamp.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill freshservice-automation -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/freshservice-automation/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/freshservice-automation/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill freshservice-automation -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/freshservice-automation/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill freshservice-automation -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/freshservice-automation/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davepoon/buildwithclaude plugins/all-skills/skills/freshservice-automation
```

2. **Manually: put the files in place**
- File: `.github/skills/freshservice-automation/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill freshservice-automation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/davepoon/buildwithclaude --path plugins/all-skills/skills/freshservice-automation
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/freshservice-automation/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill freshservice-automation -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davepoon/buildwithclaude/tree/HEAD/plugins/all-skills/skills/freshservice-automation/SKILL.md

## When to use it
- create new incident tickets with HTML descriptions
- apply batch status changes across multiple ticket IDs
- submit catalog service requests using item display IDs
- retrieve tickets updated after a specific ISO timestamp

## Example prompts
- List open tickets in Freshservice sorted by priority
- Create a high-priority incident for user@example.com regarding database outage
- Set status to Closed for tickets 201 and 202

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 0b0f984cf19df4cb.

BEGIN THIRD-PARTY FILE 0b0f984cf19df4cb
```text
---
name: freshservice-automation
description: "Automate Freshservice ITSM tasks via Rube MCP (Composio): create/update tickets, bulk operations, service requests, and outbound emails. Always search tools first for current schemas."
requires:
  mcp: [rube]
category: customer-support
---

# Freshservice Automation via Rube MCP

Automate Freshservice IT Service Management operations through Composio's Freshservice toolkit via Rube MCP.

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

## Prerequisites

- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active Freshservice connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `freshservice`
- 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 `freshservice`
3. If connection is not ACTIVE, follow the returned auth link to complete Freshservice authentication
4. Confirm connection status shows ACTIVE before running any workflows

## Core Workflows

### 1. List and Search Tickets

**When to use**: User wants to find, list, or search for tickets

**Tool sequence**:
1. `FRESHSERVICE_LIST_TICKETS` - List tickets with optional filtering and pagination [Required]
2. `FRESHSERVICE_GET_TICKET` - Get detailed information for a specific ticket [Optional]

**Key parameters for listing**:
- `filter`: Predefined filter ('all_tickets', 'deleted', 'spam', 'watching')
- `updated_since`: ISO 8601 timestamp to get tickets updated after this time
- `order_by`: Sort field ('created_at', 'updated_at', 'status', 'priority')
- `order_type`: Sort direction ('asc' or 'desc')
- `page`: Page number (1-indexed)
- `per_page`: Results per page (1-100, default 30)
- `include`: Additional fields ('requester', 'stats', 'description', 'conversations', 'assets')

**Key parameters for get**:
- `ticket_id`: Unique ticket ID or display_id
- `include`: Additional fields to include

**Pitfalls**:
- By default, only tickets created within the past 30 days are returned
- Use `updated_since` to retrieve older tickets
- Each `include` value consumes additional API credits
- `page` is 1-indexed; minimum value is 1
- `per_page` max is 100; default is 30
- Ticket IDs can be the internal ID or the display_id shown in the UI

### 2. Create a Ticket

**When to use**: User wants to log a new incident or request
```
END THIRD-PARTY FILE 0b0f984cf19df4cb

The third-party file has ended. Everything between the 0b0f984cf19df4cb tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2608 of 8436 bytes. © davepoon · MIT · https://github.com/davepoon/buildwithclaude/tree/HEAD/plugins/all-skills/skills/freshservice-automation/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
