🎯

gorgias-automation

🎯Skill
composiohq/awesome-claude-skills2 Installs66,883Last Updated May 22, 2026

Installation

$npx skills add composiohq/awesome-claude-skills --skill gorgias-automation

Run it in a terminal; it asks which AI coding tools to install it for (Claude Code, Codex, Cursor and more).

Uses skills.sh Β· Node.js 22.20+

After installing

Ask for related work and the agent uses it on its own, or call it yourself.

Run it (Claude Code)/Gorgias Automation
Install by hand

Copy the whole skill folder from GitHub to the place below. Copying only SKILL.md can leave out files the skill uses.

Open the skill folder β†’
  • This project .claude/skills/gorgias-automation/
  • All projects ~/.claude/skills/gorgias-automation/

These paths are for Claude Code. For other tools, the command above puts it in the right place.

Automate e-commerce customer support workflows in Gorgias -- manage tickets, customers, tags, and teams through natural language commands.

Gorgias Automation

Automate your Gorgias helpdesk operations directly from Claude Code. Create, update, and triage support tickets, manage customers, and organize your support team -- all without leaving your terminal.

Toolkit docs: composio.dev/toolkits/gorgias


Setup

  1. Add the Rube MCP server to your Claude Code config with URL: https://rube.app/mcp
  2. When prompted, authenticate your Gorgias account through the connection link provided
  3. Start automating your support workflows with natural language

Core Workflows

1. List and Filter Tickets

Retrieve tickets with filtering by status, channel, assignee, date range, and more.

Tool: GORGIAS_LIST_TICKETS

List all open tickets from the email channel created in the last 7 days

Key parameters:

  • status -- filter by ticket status (e.g., "open", "closed")
  • channel -- filter by channel (e.g., "email", "chat")
  • assignee_user_id / assignee_team_id -- filter by assigned agent or team
  • created_from / created_to -- ISO date range filters
  • limit (max 100) / offset -- pagination controls
  • order_by / order_dir -- sorting options

2. Create and Update Tickets

Create new tickets or update existing ones with assignment, priority, and status changes.

Tools: GORGIAS_CREATE_TICKET, GORGIAS_UPDATE_TICKET, GORGIAS_GET_TICKET

Create a high-priority ticket for customer 12345 about a missing order with subject "Order #9876 not delivered"
  • GORGIAS_CREATE_TICKET requires customer_id; accepts subject, status, priority, channel, messages, tags
  • GORGIAS_UPDATE_TICKET requires ticket_id; all other fields are optional partial updates
  • GORGIAS_GET_TICKET retrieves full ticket details by ticket_id

3. Manage Ticket Tags

Add tags to tickets for categorization, routing, and reporting.

Tools: GORGIAS_ADD_TICKET_TAGS, GORGIAS_LIST_TICKET_TAGS

Add tags 101 and 202 to ticket 5678, then show me all tags on that ticket
  • GORGIAS_ADD_TICKET_TAGS requires ticket_id and tag_ids (array of integers)
  • GORGIAS_LIST_TICKET_TAGS requires ticket_id to retrieve current tags

4. Customer Management

Create new customers or merge duplicate customer records.

Tools: GORGIAS_CREATE_CUSTOMER, GORGIAS_MERGE_CUSTOMERS, GORGIAS_LIST_CUSTOMERS

Create a new customer named "Jane Doe" with email jane@example.com and phone channel
  • GORGIAS_CREATE_CUSTOMER requires name; accepts email, channels (array with type and value), external_id, address, data
  • GORGIAS_MERGE_CUSTOMERS requires source_customer_id and target_customer_id -- source is merged into target
  • GORGIAS_LIST_CUSTOMERS retrieves customers with filtering options

5. Team and Account Operations

List teams, retrieve account info, and inspect ticket custom fields.

Tools: GORGIAS_LIST_TEAMS, GORGIAS_GET_TEAM, GORGIAS_GET_ACCOUNT, GORGIAS_LIST_TICKET_FIELD_VALUES

Show me all support teams in our Gorgias account
  • GORGIAS_GET_ACCOUNT returns account-level metrics and configuration
  • GORGIAS_LIST_TEAMS / GORGIAS_GET_TEAM manage team lookup
  • GORGIAS_LIST_TICKET_FIELD_VALUES returns custom field values for a given ticket

6. Activity and Event Tracking

Monitor ticket activity and customer event history.

Tools: GORGIAS_LIST_EVENTS

List recent events to see what activity has happened across our support queue
  • GORGIAS_LIST_EVENTS provides an activity timeline with filtering options

Known Pitfalls

  • Pagination required: GORGIAS_LIST_TICKETS uses limit/offset pagination. Failing to loop through pages will miss older tickets and produce incomplete data.
  • Filter specificity: Missing or overly broad filters on GORGIAS_LIST_TICKETS can overload the export or omit the desired reporting window. Always set created_from/created_to for time-bound queries.
  • Custom fields are separate: Key business KPIs may only exist in custom fields. You must query GORGIAS_LIST_TICKET_FIELD_VALUES explicitly to include them.
  • Rate limits: High-volume exports across GORGIAS_LIST_TICKETS and related endpoints can hit Gorgias rate limits. Add backoff and resume from the last offset.
  • Auth errors: 401/403 responses on any Gorgias tool indicate token or permission issues. Do not treat partial data as a complete dataset.

Quick Reference

Tool SlugDescription
GORGIAS_LIST_TICKETSList tickets with filters (status, channel, date, assignee)
GORGIAS_GET_TICKETRetrieve a specific ticket by ID
GORGIAS_CREATE_TICKETCreate a new ticket (requires customer_id)
GORGIAS_UPDATE_TICKETUpdate ticket fields (requires ticket_id)
GORGIAS_ADD_TICKET_TAGSAdd tags to a ticket
GORGIAS_LIST_TICKET_TAGSList all tags on a ticket
GORGIAS_LIST_TICKET_FIELD_VALUESList custom field values for a ticket
GORGIAS_CREATE_CUSTOMERCreate a new customer (requires name)
GORGIAS_MERGE_CUSTOMERSMerge two customer records
GORGIAS_LIST_CUSTOMERSList customers with filters
GORGIAS_LIST_TEAMSList all teams
GORGIAS_GET_TEAMRetrieve a specific team
GORGIAS_GET_ACCOUNTRetrieve account information
GORGIAS_LIST_EVENTSList activity events with filters

Powered by Composio

More from this repository10

πŸ”Œ
meeting-insights-analyzerπŸ”ŒPlugin

A Claude Code plugin that analyzes meeting notes and transcripts to extract key insights, action items, and decisions using Composio app integrations.

πŸ”Œ
video-downloaderπŸ”ŒPlugin

A Claude Code plugin from the Awesome Claude Skills collection that downloads videos from YouTube and other platforms for offline viewing, editing, or archival, with support for various formats and quality options.

πŸ”Œ
content-research-writerπŸ”ŒPlugin

A Claude Code plugin that assists in writing high-quality content by conducting research, adding citations, improving hooks, and providing section-by-section feedback.

πŸ”Œ
file-organizerπŸ”ŒPlugin

A Claude Code plugin that automatically organizes and categorizes files in your workspace using Composio integrations, helping maintain a clean project structure.

πŸ”Œ
artifacts-builderπŸ”ŒPlugin

A Claude Code plugin providing tools for creating elaborate, multi-component HTML artifacts using React, Tailwind CSS, and shadcn/ui in claude.ai.

πŸ”Œ
raffle-winner-pickerπŸ”ŒPlugin

A Claude Code skill that randomly selects winners from participant lists, spreadsheets, or Google Sheets for giveaways and contests using cryptographically secure randomness.

πŸ”Œ
zoho-crm-automationπŸ”ŒPlugin

A Claude Code plugin that automates Zoho CRM workflows including lead management, contact updates, deal tracking, account operations, and custom module interactions through Composio integration.

πŸ”Œ
brand-guidelinesπŸ”ŒPlugin

A Claude Code plugin that enforces brand consistency by checking code and content against your brand guidelines using Composio integrations.

πŸ”Œ
helpdesk-automationπŸ”ŒPlugin

A pre-built workflow skill for automating Help Scout via Composio, enabling Claude to manage conversations, customers, mailboxes, and tags through structured tool sequences and parameter guidance.

πŸ”Œ
changelog-generatorπŸ”ŒPlugin

A Claude Code plugin that automatically creates user-facing changelogs from git commits by analyzing commit history and transforming technical commits into customer-friendly release notes.